@@ -41,26 +41,26 @@ So, for example, when you run `x.py test [--stage 1]`,
41
41
that means to build the compiler in row 1 and column 0, then run it on the testsuite.
42
42
This corresponds to the ` run-stage ` diagram.
43
43
However, when you run ` x.py build [--stage 1] ` , that means to build the compiler in
44
- row 2 and column 1. This corresponds to the ` link -stage` diagram.
44
+ row 2 and column 1. This corresponds to the ` build -stage` diagram.
45
45
Building any of the items in the diagram also requires first building all items with arrows pointing to it.
46
46
47
- ### What are ` run-stage ` and ` link -stage` ?
47
+ ### What are ` run-stage ` and ` build -stage` ?
48
48
49
49
` run-stage ` means that this deals with _ running_ the compiler,
50
50
so ` --stage N ` refers to the artifacts in ` build/stageN ` .
51
51
52
- ` link -stage` means that this deals with _ building_ the compiler,
52
+ ` build -stage` means that this deals with _ building_ the compiler,
53
53
and it refers to ` build/stageN-component ` .
54
54
55
55
` build/stageN ` is suitable for use with ` rustup toolchain link ` ,
56
56
but ` stageN-component ` never has enough components to be usable (since it only has one).
57
57
Copying these artifacts from ` stage(N-1)-component ` to ` stageN `
58
58
is called _ uplifting_ the artifacts to ` stageN ` .
59
59
60
- ### Why have ` link -stage` at all?
60
+ ### Why have ` build -stage` at all?
61
61
62
62
` stage0/bin/rustc ` can't open an rlib from stage1-* or vice-versa.
63
- They are completely separate worlds, and ` link -stage` reflects those worlds quite directly.
63
+ They are completely separate worlds, and ` build -stage` reflects those worlds quite directly.
64
64
Say you want to build a custom driver and you've run
65
65
` rustup toolchain link build/*/stage1 ` : you have to run
66
66
` x.py build --stage 1 src/librustc_driver ` to have it available.
0 commit comments