@@ -117,7 +117,8 @@ This is a detailed look into the separate bootstrap stages.
117
117
The convention ` x.py ` uses is that:
118
118
- A ` --stage N ` flag means to run the stage N compiler (` stageN/rustc ` ).
119
119
- A "stage N artifact" is an artifact that is _ produced_ by the stage N compiler.
120
- - The "stage (N+1) compiler" is assembled from "stage N artifacts". This process is called _ uplifting_ .
120
+ - The "stage (N+1) compiler" is assembled from "stage N artifacts". This
121
+ process is called _ uplifting_ .
121
122
122
123
For example, ` x.py build --stage 0 ` means to build with the beta ` rustc ` , and
123
124
` test --stage 0 ` isn't really meaningful (it's not running tests on your changes,
@@ -134,7 +135,8 @@ will later be uplifted to stage1_.
134
135
In each stage, two major steps are performed:
135
136
136
137
1 . ` std ` is compiled by the stage N compiler.
137
- 2 . That ` std ` is linked to programs built by the stage N compiler, including the stage (N+1) compiler.
138
+ 2 . That ` std ` is linked to programs built by the stage N compiler, including
139
+ the stage (N+1) compiler.
138
140
139
141
This is somewhat intuitive if one thinks of the stage (N+1) compiler as "just"
140
142
another program we are building with the stage N compiler:
@@ -155,7 +157,8 @@ The stage 1 artifacts are what is shipped to end-users, including `stage2/bin/ru
155
157
156
158
Note that there are two ` std ` libraries in play here:
157
159
1 . The library _ linked_ to ` stageN/rustc ` , which was built by stage N-1 (stage N-1 ` std ` )
158
- 2 . The library _ used to compile programs_ with ` stageN/rustc ` , which was built by stage N (stage N ` std ` ).
160
+ 2 . The library _ used to compile programs_ with ` stageN/rustc ` , which was
161
+ built by stage N (stage N ` std ` ).
159
162
160
163
stage N ` std ` is pretty much necessary for any useful work with the compiler.
161
164
Without it, you can only compile programs with ` #![no_core] ` -- not terribly useful!
0 commit comments