mirror
/
rustc-dev-guide
mirror of https://github.com/rust-lang/rustc-dev-guide.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add bootstrapping diagram 

This diagram is based on the diagram in Joshua Nelson's talk on
bootstrapping at RustConf 2022 [1]. I converted it to Mermaid and made
some tweaks to simplify it and bring it closer to bootstrap's
terminology, and then Ralf Jung added nodes for copying artifacts.

[1]: https://rustconf.com/schedule#bootstrapping-the-once-and-future-compiler

Co-authored-by: Joshua Nelson <github@jyn.dev>
Co-authored-by: Ralf Jung <post@ralfj.de>
This commit is contained in:
Noah Lev 2022-08-09 14:19:33 -07:00 committed by Joshua Nelson
parent 7e95f0ee6a
commit ebad7d357a
1 changed files with 19 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
src/building/bootstrapping.md
View File

@ -18,7 +18,25 @@ rustc, then uses it to compile the new compiler.
## Stages of bootstrapping
Compiling `rustc` is done in stages.
Compiling `rustc` is done in stages. Here's a diagram, adapted from Joshua Nelson's
[talk on bootstrapping][rustconf22-talk] at RustConf 2022, with detailed explanations below.
The `A`, `B`, `C`, and `D` show the ordering of the stages of bootstrapping.
[rustconf22-talk]: https://rustconf.com/schedule#bootstrapping-the-once-and-future-compiler
```mermaid
graph TD
s0c["stage0 compiler (1.63)"] -->|A| s0l("stage0 std (1.64)");
s0c & s0l --- stepb[ ]:::empty;
stepb -->|B| s0ca["stage0 compiler artifacts (1.64)"];
s0ca -->|copy| s1c["stage1 compiler (1.64)"];
s1c -->|C| s1l("stage1 std (1.64)");
s1c & s1l --- stepd[ ]:::empty;
stepd -->|D| s1ca["stage1 compiler artifacts (1.64)"];
s1ca -->|copy| s2c["stage2 compiler"];
classDef empty width:0px,height:0px;
```
### Stage 0