@@ -26,10 +26,10 @@ The script accepts commands, flags, and arguments to determine what to do:
26
26
27
27
```
28
28
# build the whole compiler
29
- ./x.py build
29
+ ./x.py build --stage 2
30
30
31
31
# build the stage1 compiler
32
- ./x.py build --stage 1
32
+ ./x.py build
33
33
34
34
# build stage0 libstd
35
35
./x.py build --stage 0 library/std
@@ -43,8 +43,8 @@ The script accepts commands, flags, and arguments to determine what to do:
43
43
that belong to stage n or earlier:
44
44
45
45
```
46
- # keep old build products for stage 0 and build stage 1
47
- ./x.py build --keep-stage 0 --stage 1
46
+ # build stage 1, keeping old build products for stage 0
47
+ ./x.py build --keep-stage 0
48
48
```
49
49
50
50
* ` test ` - a command for executing unit tests. Like the ` build ` command this
@@ -123,24 +123,8 @@ that (b) leverage Rust as much as possible!
123
123
124
124
## Incremental builds
125
125
126
- You can configure rustbuild to use incremental compilation. Because
127
- incremental is new and evolving rapidly, if you want to use it, it is
128
- recommended that you replace the snapshot with a locally installed
129
- nightly build of rustc. You will want to keep this up to date.
130
-
131
- To follow this course of action, first thing you will want to do is to
132
- install a nightly, presumably using ` rustup ` . You will then want to
133
- configure your directory to use this build, like so:
134
-
135
- ``` sh
136
- # configure to use local rust instead of downloading a beta.
137
- # `--local-rust-root` is optional here. If elided, we will
138
- # use whatever rustc we find on your PATH.
139
- $ ./configure --local-rust-root=~ /.cargo/ --enable-local-rebuild
140
- ```
141
-
142
- After that, you can use the ` --incremental ` flag to actually do
143
- incremental builds:
126
+ You can configure rustbuild to use incremental compilation with the
127
+ ` --incremental ` flag:
144
128
145
129
``` sh
146
130
$ ./x.py build --incremental
@@ -150,9 +134,7 @@ The `--incremental` flag will store incremental compilation artifacts
150
134
in ` build/<host>/stage0-incremental ` . Note that we only use incremental
151
135
compilation for the stage0 -> stage1 compilation -- this is because
152
136
the stage1 compiler is changing, and we don't try to cache and reuse
153
- incremental artifacts across different versions of the compiler. For
154
- this reason, ` --incremental ` defaults to ` --stage 1 ` (though you can
155
- manually select a higher stage, if you prefer).
137
+ incremental artifacts across different versions of the compiler.
156
138
157
139
You can always drop the ` --incremental ` to build as normal (but you
158
140
will still be using the local nightly as your bootstrap).
331
313
` Config ` struct.
332
314
* Adding a sanity check? Take a look at ` bootstrap/sanity.rs ` .
333
315
334
- If you have any questions feel free to reach out on ` # infra` channel in the
335
- [ Rust Discord server] [ rust-discord ] or ask on internals.rust-lang.org. When
316
+ If you have any questions feel free to reach out on the ` #t- infra` channel in
317
+ the [ Rust Zulip server] [ rust-zulip ] or ask on internals.rust-lang.org. When
336
318
you encounter bugs, please file issues on the rust-lang/rust issue tracker.
337
319
338
- [ rust-discord ] : https://discord.gg/ rust-lang
320
+ [ rust-zulip ] : https://rust-lang.zulipchat.com/#narrow/stream/242791-t-infra
0 commit comments