From 790005d00c8925b3fb3e36627ac9f299f14731bf Mon Sep 17 00:00:00 2001 From: Tshepang Mbambo Date: Mon, 15 Jun 2026 09:21:32 +0200 Subject: [PATCH 1/3] adjust --keep-stage-std section Some may not see 30s as "very fast", so keep the sentence objective --- src/building/suggested.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/building/suggested.md b/src/building/suggested.md index c8b25edc1e..2cd75302dc 100644 --- a/src/building/suggested.md +++ b/src/building/suggested.md @@ -329,7 +329,7 @@ A common example is that you need to add a `debug!` statement to inspect the val some state or better understand the problem. In that case, you don't really need a full build. By bypassing bootstrap's cache invalidation, you can often get -these builds to complete very fast (e.g., around 30 seconds). The only catch is +these builds to complete faster. The only catch is this requires a bit of fudging and may produce compilers that don't work (but that is easily detected and fixed). From 5c3ca5bc4ca4e28fc84bad3f7d615b1c4e81f084 Mon Sep 17 00:00:00 2001 From: Tshepang Mbambo Date: Mon, 15 Jun 2026 09:24:24 +0200 Subject: [PATCH 2/3] remove the overemphasis --- src/building/suggested.md | 1 - 1 file changed, 1 deletion(-) diff --git a/src/building/suggested.md b/src/building/suggested.md index 2cd75302dc..7c9993ac88 100644 --- a/src/building/suggested.md +++ b/src/building/suggested.md @@ -337,7 +337,6 @@ The sequence of commands you want is as follows: - Initial build: `./x build library` - Subsequent builds: `./x build library --keep-stage-std=1` - - Note that we added the `--keep-stage-std=1` flag here As mentioned, the effect of `--keep-stage-std=1` is that we just _assume_ that the old standard library can be re-used. From 478e2fb3bc890538cb6e537ae97d635bceb49439 Mon Sep 17 00:00:00 2001 From: Tshepang Mbambo Date: Mon, 15 Jun 2026 09:29:17 +0200 Subject: [PATCH 3/3] use more normal text - TL;DR is something many would not know the meaning of. - Remove sentence that is implied --- src/building/suggested.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/src/building/suggested.md b/src/building/suggested.md index 7c9993ac88..09b190d6be 100644 --- a/src/building/suggested.md +++ b/src/building/suggested.md @@ -347,11 +347,10 @@ the compiler, which controls how the compiler encodes types and other states into the `rlib` files, or if you are editing things that wind up in the metadata (such as the definition of the MIR). -**The TL;DR is that you might get weird behavior from a compile when using -`--keep-stage-std=1`** -- for example, strange [ICEs](../appendix/glossary.html#ice) +That is, you might get weird behavior from a compile when using +`--keep-stage-std=1`, for example, strange [ICEs](../appendix/glossary.html#ice) or other panics. In that case, you should simply remove the `--keep-stage-std=1` from the command and rebuild. -That ought to fix the problem. You can also use `--keep-stage-std=1` when running tests. Something like this: