Skip to content

Commit 5c85adc

Browse files
committed
Add cross-complation comment
1 parent 51d48f0 commit 5c85adc

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

src/bootstrap/src/lib.rs

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -271,6 +271,12 @@ pub enum Mode {
271271
/// It is used e.g. for linkers and linker tools invoked by rustc on its host target.
272272
///
273273
/// These tools participate in staging only when required for cross-compilation.
274+
///
275+
/// Note: since these tools are built with a different compiler when compiling for the host
276+
/// vs when cross-compiling, such a situation will not produce the exactly identical binary.
277+
/// The same will happen when using the `local_rebuild` feature (where stage0 is actually
278+
/// an in-tree compiler). We considered this (https://github.com/rust-lang/rust/pull/143581)
279+
/// and determined that it should not be an issue in practice.
274280
ToolTarget,
275281

276282
/// Build a tool which uses the locally built std, placing output in the

0 commit comments

Comments
 (0)