Add information about default stages for x.py

This commit is contained in:
Joshua Nelson 2020-09-09 09:18:59 -04:00 committed by Joshua Nelson
parent 794b32feac
commit 8623da3dab
1 changed files with 14 additions and 0 deletions

View File

@ -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 build the new compiler with itself. For development, you usually only want
the `stage1` compiler: `x.py build library/std`. 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 ## Complications of bootstrapping
Since the build system uses the current beta compiler to build the stage-1 Since the build system uses the current beta compiler to build the stage-1