@@ -71,26 +71,26 @@ So, for example, when you run `x.py test [--stage 1]`,
71
71
that means to build the compiler in row 1 and column 0, then run it on the testsuite.
72
72
This corresponds to the ` run-stage ` diagram.
73
73
However, when you run ` x.py build [--stage 1] ` , that means to build the compiler in
74
- row 2 and column 1. This corresponds to the ` link -stage` diagram.
74
+ row 2 and column 1. This corresponds to the ` build -stage` diagram.
75
75
Building any of the items in the diagram also requires first building all items with arrows pointing to it.
76
76
77
- ### What are ` run-stage ` and ` link -stage` ?
77
+ ### What are ` run-stage ` and ` build -stage` ?
78
78
79
79
` run-stage ` means that this deals with _ running_ the compiler,
80
80
so ` --stage N ` refers to the artifacts in ` build/stageN ` .
81
81
82
- ` link -stage` means that this deals with _ building_ the compiler,
82
+ ` build -stage` means that this deals with _ building_ the compiler,
83
83
and it refers to ` build/stageN-component ` .
84
84
85
85
` build/stageN ` is suitable for use with ` rustup toolchain link ` ,
86
86
but ` stageN-component ` never has enough components to be usable (since it only has one).
87
87
Copying these artifacts from ` stage(N-1)-component ` to ` stageN `
88
88
is called _ uplifting_ the artifacts to ` stageN ` .
89
89
90
- ### Why have ` link -stage` at all?
90
+ ### Why have ` build -stage` at all?
91
91
92
92
` stage0/bin/rustc ` can't open an rlib from stage1-* or vice-versa.
93
- They are completely separate worlds, and ` link -stage` reflects those worlds quite directly.
93
+ They are completely separate worlds, and ` build -stage` reflects those worlds quite directly.
94
94
Say you want to build a custom driver and you've run
95
95
` rustup toolchain link build/*/stage1 ` : you have to run
96
96
` x.py build --stage 1 src/librustc_driver ` to have it available.
0 commit comments