Skip to content

Commit 9626f03

Browse files
committed
Improve wording for section heading
also adds another example of what not to do
1 parent f20187b commit 9626f03

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

src/building/bootstrapping.md

+6-1
Original file line numberDiff line numberDiff line change
@@ -146,14 +146,19 @@ The convention `x.py` uses is that:
146146
`compiletest` on it. If you're working on the compiler, this is normally the
147147
test command you want.
148148

149-
#### Non-examples
149+
#### Examples of what *not* to do
150150

151151
- `x.py test --stage 0 src/test/ui` is not meaningful: it runs tests on the
152152
_beta_ compiler and doesn't build `rustc` from source. Use `test src/test/ui`
153153
instead, which builds stage 1 from source.
154154
- `x.py test --stage 0 compiler/rustc` builds the compiler but runs no tests:
155155
it's running `cargo test -p rustc`, but cargo doesn't understand Rust's
156156
tests. You shouldn't need to use this, use `test` instead (without arguments).
157+
- `x.py build --stage 0 compiler/rustc` builds the compiler, but does not make
158+
it usable: the build artifacts are not uplifted ([#73519]). Use `build
159+
library/std` instead which puts the compiler in `stage1/rustc`.
160+
161+
[#73519]: https://github.com/rust-lang/rust/issues/73519
157162

158163
### Building vs. Running
159164

0 commit comments

Comments
 (0)