File tree Expand file tree Collapse file tree 1 file changed +11
-1
lines changed Expand file tree Collapse file tree 1 file changed +11
-1
lines changed Original file line number Diff line number Diff line change @@ -57,7 +57,17 @@ but `stageN-component` never has enough components to be usable (since it only h
57
57
Copying these artifacts from ` stage(N-1)-component ` to ` stageN `
58
58
is called _ uplifting_ the artifacts to ` stageN ` .
59
59
60
- <!-- TODO: say _why_ build-stage exists and is separate. -->
60
+ ### Why have ` link-stage ` at all?
61
+
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.
64
+ Say you want to build a custom driver and you've run
65
+ ` rustup toolchain link build/*/stage1 ` : you have to run
66
+ ` x.py build --stage 1 src/librustc_driver ` to have it available.
67
+ The stage number corresponds to the "world" you have to be in to use it.
68
+ If this used ` run-stage ` instead, you'd need ` x.py build --stage 1 ` to build
69
+ a regular program, but ` x.py build --stage 2 src/librustc_driver ` to build a
70
+ custom driver.
61
71
62
72
## Complications of bootstrapping
63
73
You can’t perform that action at this time.
0 commit comments