about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorNiko Matsakis <niko@alum.mit.edu>2018-01-31 14:18:51 -0500
committerNiko Matsakis <niko@alum.mit.edu>2018-01-31 14:18:51 -0500
commit12243df6b46ea6dbe142171bb5177f8b4311b968 (patch)
treedcd27f8a7c1349731638d2684d5b6d641b731ca5 /src/doc/rustc-dev-guide
parentb354719755519e40624ec3527c3dd58110933af2 (diff)
downloadrust-12243df6b46ea6dbe142171bb5177f8b4311b968.tar.gz
rust-12243df6b46ea6dbe142171bb5177f8b4311b968.zip
update wording to be a bit more clear
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/how-to-build-and-run.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/src/doc/rustc-dev-guide/src/how-to-build-and-run.md b/src/doc/rustc-dev-guide/src/how-to-build-and-run.md
index 24cfbfad72b..7992dc98743 100644
--- a/src/doc/rustc-dev-guide/src/how-to-build-and-run.md
+++ b/src/doc/rustc-dev-guide/src/how-to-build-and-run.md
@@ -54,12 +54,16 @@ compiler to compile the newer version. In particular, the newer version of the
 compiler, `libstd`, and other tooling may use some unstable features
 internally. The result is the compiling `rustc` is done in stages.
 
-- Stage 0: the current _beta_ compiler is compiled using the current _stable_ compiler.
-- Stage 1: the code in your clone is then compiled with the stage 0 compiler.
-- Stage 2: the code in your clone is then compiled with the stage 1 compiler (i.e. it builds itself).
-
-For hacking, often building the stage 1 compiler is enough, but for testing and
-release, the stage 2 compiler is used.
+- **Stage 0:** the stage0 compiler is the current _beta_ compiler; we
+  download this binary from the internet.
+- **Stage 1:** the code in your clone is then compiled with the stage
+  0 compiler to produce the stage 1 compiler.
+- **Stage 2:** the code in your clone is then compiled with the stage
+  1 compiler *again* to produce the stage 2 compiler (i.e. it builds
+  itself).
+
+For hacking, often building the stage 1 compiler is enough, but for
+final testing and release, the stage 2 compiler is used.
 
 Once you've created a config.toml, you are now ready to run
 `x.py`. There are a lot of options here, but let's start with what is