diff options
| author | Joshua Nelson <github@jyn.dev> | 2021-10-17 13:17:19 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-18 02:17:19 +0900 |
| commit | 3bd8a0ed5298f5e8aca0004e5e6a8dcab4f286a5 (patch) | |
| tree | 9fb2b7882913c44cb265bc8359ad620107a6bb59 /src/doc/rustc-dev-guide | |
| parent | 0ed4e95a01b20157dee63ab7a885b12ade8fdb4f (diff) | |
| download | rust-3bd8a0ed5298f5e8aca0004e5e6a8dcab4f286a5.tar.gz rust-3bd8a0ed5298f5e8aca0004e5e6a8dcab4f286a5.zip | |
Remove docs on Assemble step (#1233)
Diffstat (limited to 'src/doc/rustc-dev-guide')
| -rw-r--r-- | src/doc/rustc-dev-guide/src/building/bootstrapping.md | 23 |
1 files changed, 4 insertions, 19 deletions
diff --git a/src/doc/rustc-dev-guide/src/building/bootstrapping.md b/src/doc/rustc-dev-guide/src/building/bootstrapping.md index 876c565abb3..26527ec9c9a 100644 --- a/src/doc/rustc-dev-guide/src/building/bootstrapping.md +++ b/src/doc/rustc-dev-guide/src/building/bootstrapping.md @@ -149,20 +149,6 @@ Build artifacts include, but are not limited to: [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 - `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: 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). -- `x.py build --stage 0 compiler/rustc` builds the compiler, but does - not [assemble] it. Use `x.py build library/std` instead, which puts the - compiler in `stage1/rustc`. - -[assemble]: #assembling-the-compiler +- `x.py build --stage 0 compiler/rustc` builds the compiler, but does not build + libstd or even libcore. Most of the time, you'll want `x.py build + library/std` instead, which allows compiling programs without needing to define + lang items. ### Building vs. Running |
