1- # rustbuild - Bootstrapping Rust
1+ # Bootstrapping Rust
22
33This README is aimed at helping to explain how Rust is bootstrapped,
4- and some of the technical details of the build system.
4+ and some of the technical details of the bootstrap build system.
55
66Note that this README only covers internal information, not how to use the tool.
77Please check [ bootstrapping dev guide] [ bootstrapping-dev-guide ] for further information.
@@ -12,17 +12,17 @@ Please check [bootstrapping dev guide][bootstrapping-dev-guide] for further info
1212
1313The build system defers most of the complicated logic of managing invocations
1414of rustc and rustdoc to Cargo itself. However, moving through various stages
15- and copying artifacts is still necessary for it to do. Each time rustbuild
15+ and copying artifacts is still necessary for it to do. Each time bootstrap
1616is invoked, it will iterate through the list of predefined steps and execute
1717each serially in turn if it matches the paths passed or is a default rule.
18- For each step, rustbuild relies on the step internally being incremental and
19- parallel. Note, though, that the ` -j ` parameter to rustbuild gets forwarded
18+ For each step, bootstrap relies on the step internally being incremental and
19+ parallel. Note, though, that the ` -j ` parameter to bootstrap gets forwarded
2020to appropriate test harnesses and such.
2121
2222## Build phases
2323
24- The rustbuild build system goes through a few phases to actually build the
25- compiler. What actually happens when you invoke rustbuild is:
24+ Bootstrap build system goes through a few phases to actually build the
25+ compiler. What actually happens when you invoke bootstrap is:
2626
27271 . The entry point script (` x ` for unix like systems, ` x.ps1 ` for windows systems,
2828 ` x.py ` cross-platform) is run. This script is responsible for downloading the stage0
@@ -151,9 +151,9 @@ build/
151151 stage3/
152152```
153153
154- ## Extending rustbuild
154+ ## Extending bootstrap
155155
156- When you use the bootstrap system , you'll call it through the entry point script
156+ When you use bootstrap, you'll call it through the entry point script
157157(` x ` , ` x.ps1 ` , or ` x.py ` ). However, most of the code lives in ` src/bootstrap ` .
158158` bootstrap ` has a difficult problem: it is written in Rust, but yet it is run
159159before the Rust compiler is built! To work around this, there are two components
0 commit comments