Skip to content

Commit 4247800

Browse files
committed
Redo examples to be less confusing
1 parent 09b2790 commit 4247800

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

src/building/bootstrapping.md

+11-5
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ It must have been written in a different language. In Rust's case it was
1414
only way to build a modern version of rustc is a slightly less modern
1515
version.
1616

17-
This is exactly how `x.py` works: it downloads the current `beta` release of
17+
This is exactly how `x.py` works: it downloads the current beta release of
1818
rustc, then uses it to compile the new compiler.
1919

2020
## Stages of bootstrapping
@@ -134,10 +134,16 @@ The convention `x.py` uses is that:
134134
- The "stage (N+1) compiler" is assembled from "stage N artifacts". This
135135
process is called _uplifting_.
136136

137-
For example, `x.py build --stage 0` means to build with the beta `rustc`, and
138-
`test --stage 0` isn't really meaningful (it's not running tests on your changes,
139-
but on `beta`, so it always fails). Similarly, `doc --stage 0` means to
140-
document using the beta `rustdoc`.
137+
#### Examples
138+
139+
- `x.py build --stage 0` means to build with the beta `rustc`.
140+
- `x.py doc --stage 0` means to document using the beta `rustdoc`.
141+
- `x.py test --stage 0 library/std` means to run tests on the standard library
142+
without building `rustc` from source ('build with stage 0, then test the artifacts').
143+
- `x.py test --stage 0 src/test/ui` is not meaningful: it runs tests on the
144+
_beta_ compiler and doesn't build `rustc` from source.
145+
146+
### Building vs. Running
141147

142148
Note that this implies the stage N compiler is _not_ the same as the compiler
143149
built by `build --stage N compiler/rustc` -- that's 'stage N artifacts'

0 commit comments

Comments
 (0)