Skip to content

Commit daa7597

Browse files
jyn514Joshua Nelson
authored andcommitted
Add information about default stages for x.py
1 parent 13c18fc commit daa7597

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

src/building/bootstrapping.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,20 @@ first build the new compiler with an older compiler and then use that to
5757
build the new compiler with itself. For development, you usually only want
5858
the `stage1` compiler: `x.py build library/std`.
5959

60+
### Default stages
61+
62+
`x.py` tries to be helpful and pick the stage you most likely meant for each subcommand.
63+
These defaults are as follows:
64+
65+
- `doc`: `--stage 0`
66+
- `build`: `--stage 1`
67+
- `test`: `--stage 1`
68+
- `dist`: `--stage 2`
69+
- `install`: `--stage 2`
70+
- `bench`: `--stage 2`
71+
72+
You can always override the stage by passing `--stage N` explicitly.
73+
6074
## Complications of bootstrapping
6175

6276
Since the build system uses the current beta compiler to build the stage-1

0 commit comments

Comments
 (0)