@@ -131,7 +131,8 @@ This is a detailed look into the separate bootstrap stages.
131
131
The convention ` x.py ` uses is that:
132
132
- A ` --stage N ` flag means to run the stage N compiler (` stageN/rustc ` ).
133
133
- A "stage N artifact" is an artifact that is _ produced_ by the stage N compiler.
134
- - The "stage (N+1) compiler" is assembled from "stage N artifacts". This process is called _ uplifting_ .
134
+ - The "stage (N+1) compiler" is assembled from "stage N artifacts". This
135
+ process is called _ uplifting_ .
135
136
136
137
For example, ` x.py build --stage 0 ` means to build with the beta ` rustc ` , and
137
138
` test --stage 0 ` isn't really meaningful (it's not running tests on your changes,
@@ -148,7 +149,8 @@ will later be uplifted to stage1_.
148
149
In each stage, two major steps are performed:
149
150
150
151
1 . ` std ` is compiled by the stage N compiler.
151
- 2 . That ` std ` is linked to programs built by the stage N compiler, including the stage (N+1) compiler.
152
+ 2 . That ` std ` is linked to programs built by the stage N compiler, including
153
+ the stage (N+1) compiler.
152
154
153
155
This is somewhat intuitive if one thinks of the stage (N+1) compiler as "just"
154
156
another program we are building with the stage N compiler:
@@ -169,7 +171,8 @@ The stage 1 artifacts are what is shipped to end-users, including `stage2/bin/ru
169
171
170
172
Note that there are two ` std ` libraries in play here:
171
173
1 . The library _ linked_ to ` stageN/rustc ` , which was built by stage N-1 (stage N-1 ` std ` )
172
- 2 . The library _ used to compile programs_ with ` stageN/rustc ` , which was built by stage N (stage N ` std ` ).
174
+ 2 . The library _ used to compile programs_ with ` stageN/rustc ` , which was
175
+ built by stage N (stage N ` std ` ).
173
176
174
177
stage N ` std ` is pretty much necessary for any useful work with the compiler.
175
178
Without it, you can only compile programs with ` #![no_core] ` -- not terribly useful!
0 commit comments