mirror
/
rustc-dev-guide
mirror of https://github.com/rust-lang/rustc-dev-guide.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Remove docs on Assemble step (#1233)

This commit is contained in:
Joshua Nelson 2021-10-17 13:17:19 -04:00 committed by GitHub
parent fba15a46ca
commit 4ff071741a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
src/building/bootstrapping.md
View File

@ -149,20 +149,6 @@ Build artifacts include, but are not limited to:
[rlib]: ../serialization.md [rlib]: ../serialization.md
#### Assembling the compiler
There is a separate step between building the compiler and making it possible
to run. This step is called _assembling_ or _uplifting_ the compiler. It copies
all the necessary build artifacts from `build/stageN-sysroot` to
`build/stage(N+1)`, which allows you to use `build/stage(N+1)` as a [toolchain]
with `rustup toolchain link`.
There is [no way to trigger this step on its own][#73519], but `x.py` will
perform it automatically any time you build with stage N+1.
[toolchain]: https://rustc-dev-guide.rust-lang.org/building/how-to-build-and-run.html#creating-a-rustup-toolchain
[#73519]: https://github.com/rust-lang/rust/issues/73519
#### Examples #### Examples
- `x.py build --stage 0` means to build with the beta `rustc`. - `x.py build --stage 0` means to build with the beta `rustc`.
@ -183,11 +169,10 @@ perform it automatically any time you build with stage N+1.
- `x.py test --stage 0 compiler/rustc` builds the compiler but runs no tests: - `x.py test --stage 0 compiler/rustc` builds the compiler but runs no tests:
it's running `cargo test -p rustc`, but cargo doesn't understand Rust's it's running `cargo test -p rustc`, but cargo doesn't understand Rust's
tests. You shouldn't need to use this, use `test` instead (without arguments). tests. You shouldn't need to use this, use `test` instead (without arguments).
- `x.py build --stage 0 compiler/rustc` builds the compiler, but does - `x.py build --stage 0 compiler/rustc` builds the compiler, but does not build
not [assemble] it. Use `x.py build library/std` instead, which puts the libstd or even libcore. Most of the time, you'll want `x.py build
compiler in `stage1/rustc`. library/std` instead, which allows compiling programs without needing to define
lang items.
[assemble]: #assembling-the-compiler
### Building vs. Running ### Building vs. Running