about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorJoshua Nelson <jyn514@gmail.com>2020-09-09 09:18:59 -0400
committerJoshua Nelson <joshua@yottadb.com>2020-09-09 11:05:26 -0400
commit0bb78aaad6d8807e7983ba2efb4953d89a5c85c0 (patch)
tree76b83ed02a005e9a3048930d10c14462e1f8e8e8 /src/doc/rustc-dev-guide
parent09a931a4aae4cb17a1213d8dc0c7dcad636cd3d6 (diff)
downloadrust-0bb78aaad6d8807e7983ba2efb4953d89a5c85c0.tar.gz
rust-0bb78aaad6d8807e7983ba2efb4953d89a5c85c0.zip
Add information about default stages for x.py
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/building/bootstrapping.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/building/bootstrapping.md b/src/doc/rustc-dev-guide/src/building/bootstrapping.md
index 697ca80d13a..7116d908aa7 100644
--- a/src/doc/rustc-dev-guide/src/building/bootstrapping.md
+++ b/src/doc/rustc-dev-guide/src/building/bootstrapping.md
@@ -57,6 +57,20 @@ first build the new compiler with an older compiler and then use that to
 build the new compiler with itself. For development, you usually only want
 the `stage1` compiler: `x.py build library/std`.
 
+### Default stages
+
+`x.py` tries to be helpful and pick the stage you most likely meant for each subcommand.
+These defaults are as follows:
+
+- `doc`: `--stage 0`
+- `build`: `--stage 1`
+- `test`: `--stage 1`
+- `dist`: `--stage 2`
+- `install`: `--stage 2`
+- `bench`: `--stage 2`
+
+You can always override the stage by passing `--stage N` explicitly.
+
 ## Complications of bootstrapping
 
 Since the build system uses the current beta compiler to build the stage-1