Skip to content

Explain stages in terms of the compiler currently running (take N+1) #857

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Oct 4, 2020
Merged

Explain stages in terms of the compiler currently running (take N+1) #857

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8363e2a
Explain stages in terms of the compiler currently running
jyn514 Sep 8, 2020
8e7585b
build -> x.py build
jyn514 Oct 1, 2020
6730eba
Add section on build artifacts
jyn514 Oct 1, 2020
e563a4d
Improve wording
jyn514 Oct 1, 2020
ddf743f
uplifted -> assembled
jyn514 Oct 1, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions src/building/bootstrapping.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,18 @@ The convention `x.py` uses is that:
- The "stage (N+1) compiler" is assembled from "stage N artifacts". This
process is called _uplifting_.

#### Build artifacts

Anything you can build with `x.py` is a build artifact.
Build artifacts include, but are not limited to:

- binaries, like `stage0-rustc/rustc-main`
- shared objects, like `stage0-sysroot/rustlib/libstd-6fae108520cf72fe.so`
- [rlib] files, like `stage0-sysroot/rustlib/libstd-6fae108520cf72fe.rlib`
- HTML files generated by rustdoc, like `doc/std`

[rlib]: ../serialization.md

#### Examples

- `x.py build --stage 0` means to build with the beta `rustc`.
Expand Down