Skip to content

Commit 07d5532

Browse files
Fix #1737: Specify toolchain part in building and running
There was an issue raised that the toolchain explanation for building and running the compiler needed some refinement. This patch aims to remedy that by specifying what "first" and "second" refer to, and what the toolchain does. Small change to the language to specify that the stage2 toolchain is not built, and how one would build it.
1 parent bdbede8 commit 07d5532

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

src/building/how-to-build-and-run.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -277,18 +277,20 @@ default).
277277
Once you have successfully built `rustc`, you will have created a bunch
278278
of files in your `build` directory. In order to actually run the
279279
resulting `rustc`, we recommend creating rustup toolchains. The first
280-
one will run the stage1 compiler (which we built above). The second
281-
will execute the stage2 compiler (which we did not build, but which
282-
you will likely need to build at some point; for example, if you want
283-
to run the entire test suite).
280+
command listed below runs the stage1 compiler, which was built in the
281+
steps above, with the name `stage1`. The second command runs the stage2
282+
compiler using the stage1 compiler. This will be needed in the future
283+
if running the entire test suite, but will not be built in this page.
284+
Building stage2 is done with the same `./x build` command as for stage1,
285+
specifying that the stage is 2 instead.
284286

285287
```bash
286288
rustup toolchain link stage1 build/host/stage1
287289
rustup toolchain link stage2 build/host/stage2
288290
```
289291

290-
Now you can run the `rustc` you built with. If you run with `-vV`, you
291-
should see a version number ending in `-dev`, indicating a build from
292+
Now you can run the `rustc` you built with via the toolchain. If you run with
293+
`-vV`, you should see a version number ending in `-dev`, indicating a build from
292294
your local environment:
293295

294296
```bash

0 commit comments

Comments
 (0)