From 8623da3dab018b3989a8e70cb9f8978c50cb263d Mon Sep 17 00:00:00 2001 From: Joshua Nelson Date: Wed, 9 Sep 2020 09:18:59 -0400 Subject: [PATCH] Add information about default stages for x.py --- src/building/bootstrapping.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/building/bootstrapping.md b/src/building/bootstrapping.md index 697ca80d..7116d908 100644 --- a/src/building/bootstrapping.md +++ b/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