Skip to content

Commit cd2bec2

Browse files
committed
Remove docs on Assemble step
This is done automatically now, it shouldn't be necessary to know about unless you're modifying bootstrap itself.
1 parent fba15a4 commit cd2bec2

File tree

1 file changed

+4
-19
lines changed

1 file changed

+4
-19
lines changed

src/building/bootstrapping.md

+4-19
Original file line numberDiff line numberDiff line change
@@ -149,20 +149,6 @@ Build artifacts include, but are not limited to:
149149

150150
[rlib]: ../serialization.md
151151

152-
#### Assembling the compiler
153-
154-
There is a separate step between building the compiler and making it possible
155-
to run. This step is called _assembling_ or _uplifting_ the compiler. It copies
156-
all the necessary build artifacts from `build/stageN-sysroot` to
157-
`build/stage(N+1)`, which allows you to use `build/stage(N+1)` as a [toolchain]
158-
with `rustup toolchain link`.
159-
160-
There is [no way to trigger this step on its own][#73519], but `x.py` will
161-
perform it automatically any time you build with stage N+1.
162-
163-
[toolchain]: https://rustc-dev-guide.rust-lang.org/building/how-to-build-and-run.html#creating-a-rustup-toolchain
164-
[#73519]: https://github.com/rust-lang/rust/issues/73519
165-
166152
#### Examples
167153

168154
- `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.
183169
- `x.py test --stage 0 compiler/rustc` builds the compiler but runs no tests:
184170
it's running `cargo test -p rustc`, but cargo doesn't understand Rust's
185171
tests. You shouldn't need to use this, use `test` instead (without arguments).
186-
- `x.py build --stage 0 compiler/rustc` builds the compiler, but does
187-
not [assemble] it. Use `x.py build library/std` instead, which puts the
188-
compiler in `stage1/rustc`.
189-
190-
[assemble]: #assembling-the-compiler
172+
- `x.py build --stage 0 compiler/rustc` builds the compiler, but does not build
173+
libstd or even libcore. Most of the time, you'll want `x.py build
174+
library/std` instead, which allows compiling programs without needing to define
175+
lang items.
191176

192177
### Building vs. Running
193178

0 commit comments

Comments
 (0)