Skip to content

Commit 0473a9f

Browse files
committed
replace config.toml to bootstrap.toml in src:doc:rustc
1 parent 0726474 commit 0473a9f

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+57
-57
lines changed

src/doc/rustc/src/instrument-coverage.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Rust's source-based code coverage requires the Rust "profiler runtime". Without
2727

2828
The Rust `nightly` distribution channel includes the profiler runtime, by default.
2929

30-
> **Important**: If you are building the Rust compiler from the source distribution, the profiler runtime is _not_ enabled in the default `config.example.toml`. Edit your `config.toml` file and ensure the `profiler` feature is set it to `true` (either under the `[build]` section, or under the settings for an individual `[target.<triple>]`):
30+
> **Important**: If you are building the Rust compiler from the source distribution, the profiler runtime is _not_ enabled in the default `bootstrap.example.toml`. Edit your `bootstrap.toml` file and ensure the `profiler` feature is set it to `true` (either under the `[build]` section, or under the settings for an individual `[target.<triple>]`):
3131
>
3232
> ```toml
3333
> # Build the profiler runtime (required when compiling with options that depend

src/doc/rustc/src/platform-support/TEMPLATE.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ What format do binaries use by default? ELF, PE, something else?
2828
## Building the target
2929

3030
If Rust doesn't build the target by default, how can users build it? Can users
31-
just add it to the `target` list in `config.toml`?
31+
just add it to the `target` list in `bootstrap.toml`?
3232

3333
## Building Rust programs
3434

src/doc/rustc/src/platform-support/aarch64-unknown-teeos.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ exec /path/to/ohos-sdk/linux/native/llvm/bin/clang++ \
5454

5555
## Building the target
5656

57-
To build a rust toolchain, create a `config.toml` with the following contents:
57+
To build a rust toolchain, create a `bootstrap.toml` with the following contents:
5858

5959
```toml
6060
profile = "compiler"

src/doc/rustc/src/platform-support/apple-ios.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ $ rustup target add x86_64-apple-ios
4747
```
4848

4949
The tier 3 targets can be built by enabling them for a `rustc` build in
50-
`config.toml`, by adding, for example:
50+
`bootstrap.toml`, by adding, for example:
5151

5252
```toml
5353
[build]

src/doc/rustc/src/platform-support/apple-tvos.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The following APIs are currently known to have missing or incomplete support:
5252
## Building the target
5353

5454
The targets can be built by enabling them for a `rustc` build in
55-
`config.toml`, by adding, for example:
55+
`bootstrap.toml`, by adding, for example:
5656

5757
```toml
5858
[build]

src/doc/rustc/src/platform-support/apple-visionos.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ case `XROS_DEPLOYMENT_TARGET`.
3131
## Building the target
3232

3333
The targets can be built by enabling them for a `rustc` build in
34-
`config.toml`, by adding, for example:
34+
`bootstrap.toml`, by adding, for example:
3535

3636
```toml
3737
[build]

src/doc/rustc/src/platform-support/apple-watchos.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ case `WATCHOS_DEPLOYMENT_TARGET`.
3737
## Building the target
3838

3939
The targets can be built by enabling them for a `rustc` build in
40-
`config.toml`, by adding, for example:
40+
`bootstrap.toml`, by adding, for example:
4141

4242
```toml
4343
[build]

src/doc/rustc/src/platform-support/arm64e-apple-darwin.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ See the docs on [`*-apple-darwin`](apple-darwin.md) for general macOS requiremen
1616

1717
## Building the target
1818

19-
You can build Rust with support for the targets by adding it to the `target` list in `config.toml`:
19+
You can build Rust with support for the targets by adding it to the `target` list in `bootstrap.toml`:
2020

2121
```toml
2222
[build]

src/doc/rustc/src/platform-support/arm64e-apple-ios.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ See the docs on [`*-apple-ios`](apple-ios.md) for general iOS requirements.
1414

1515
## Building the target
1616

17-
You can build Rust with support for the targets by adding it to the `target` list in `config.toml`:
17+
You can build Rust with support for the targets by adding it to the `target` list in `bootstrap.toml`:
1818

1919
```toml
2020
[build]

src/doc/rustc/src/platform-support/arm64e-apple-tvos.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ To build this target Xcode 12 or higher on macOS is required.
1515

1616
## Building the target
1717

18-
You can build Rust with support for the targets by adding it to the `target` list in `config.toml`:
18+
You can build Rust with support for the targets by adding it to the `target` list in `bootstrap.toml`:
1919

2020
```toml
2121
[build]

src/doc/rustc/src/platform-support/arm64ec-pc-windows-msvc.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ To put this in practice:
5656
## Building the target
5757

5858
You can build Rust with support for the targets by adding it to the `target`
59-
list in `config.toml`:
59+
list in `bootstrap.toml`:
6060

6161
```toml
6262
[build]

src/doc/rustc/src/platform-support/armeb-unknown-linux-gnueabi.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The target definition can be seen [here](https://github.com/rust-lang/rust/blob/
2121
## Building the target
2222
Because it is Tier 3, rust does not yet ship pre-compiled artifacts for this target.
2323

24-
Therefore, you can build Rust with support for the target by adding it to the target list in config.toml, a sample configuration is shown below. It is expected that the user already have a working GNU compiler toolchain and update the paths accordingly.
24+
Therefore, you can build Rust with support for the target by adding it to the target list in bootstrap.toml, a sample configuration is shown below. It is expected that the user already have a working GNU compiler toolchain and update the paths accordingly.
2525

2626
```toml
2727
[llvm]

src/doc/rustc/src/platform-support/armv6k-nintendo-3ds.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ This target generates binaries in the ELF format.
5050
## Building the target
5151

5252
You can build Rust with support for the target by adding it to the `target`
53-
list in `config.toml` and providing paths to the devkitARM toolchain.
53+
list in `bootstrap.toml` and providing paths to the devkitARM toolchain.
5454

5555
```toml
5656
[build]

src/doc/rustc/src/platform-support/armv7-unknown-linux-uclibceabihf.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ If you don't already have a suitable toolchain, download one [here](https://tool
2222

2323
### Configure rust
2424

25-
The target can be built by enabling it for a `rustc` build, by placing the following in `config.toml`:
25+
The target can be built by enabling it for a `rustc` build, by placing the following in `bootstrap.toml`:
2626

2727
```toml
2828
[build]

src/doc/rustc/src/platform-support/csky-unknown-linux-gnuabiv2.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ If you don't already have a suitable toolchain, you can download from [here](htt
3636

3737
### Configure rust
3838

39-
The target can be built by enabling it for a `rustc` build, by placing the following in `config.toml`:
39+
The target can be built by enabling it for a `rustc` build, by placing the following in `bootstrap.toml`:
4040

4141
```toml
4242
[build]

src/doc/rustc/src/platform-support/fuchsia.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ Fuchsia as well. A recent version (14+) of clang should be sufficient to compile
180180
Rust for Fuchsia.
181181

182182
x86-64 and AArch64 Fuchsia targets can be enabled using the following
183-
configuration in `config.toml`:
183+
configuration in `bootstrap.toml`:
184184

185185
```toml
186186
[build]
@@ -212,7 +212,7 @@ cxx = "clang++"
212212

213213
By default, the Rust compiler installs itself to `/usr/local` on most UNIX
214214
systems. You may want to install it to another location (e.g. a local `install`
215-
directory) by setting a custom prefix in `config.toml`:
215+
directory) by setting a custom prefix in `bootstrap.toml`:
216216

217217
```toml
218218
[install]
@@ -695,7 +695,7 @@ We can then use the script to start our test environment with:
695695
)
696696
```
697697

698-
Where `${RUST_SRC_PATH}/build` is the `build-dir` set in `config.toml`.
698+
Where `${RUST_SRC_PATH}/build` is the `build-dir` set in `bootstrap.toml`.
699699

700700
Once our environment is started, we can run our tests using `x.py` as usual. The
701701
test runner script will run the compiled tests on an emulated Fuchsia device. To
@@ -705,7 +705,7 @@ run the full `tests/ui` test suite:
705705
( \
706706
source config-env.sh && \
707707
./x.py \
708-
--config config.toml \
708+
--config bootstrap.toml \
709709
--stage=2 \
710710
test tests/ui \
711711
--target x86_64-unknown-fuchsia \
@@ -893,7 +893,7 @@ through our `x.py` invocation. The full invocation is:
893893
( \
894894
source config-env.sh && \
895895
./x.py \
896-
--config config.toml \
896+
--config bootstrap.toml \
897897
--stage=2 \
898898
test tests/${TEST} \
899899
--target x86_64-unknown-fuchsia \

src/doc/rustc/src/platform-support/hermit.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Hermit binaries have the ELF format.
3131

3232
## Building the target
3333

34-
You can build Rust with support for the targets by adding it to the `target` list in `config.toml`.
34+
You can build Rust with support for the targets by adding it to the `target` list in `bootstrap.toml`.
3535
To run the Hermit build scripts, you also have to enable your host target.
3636
The build scripts rely on `llvm-tools` and binaries are linked using `rust-lld`, so those have to be enabled as well.
3737

src/doc/rustc/src/platform-support/hexagon-unknown-linux-musl.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Because it is Tier 3, rust does not yet ship pre-compiled artifacts for this
4444
target.
4545

4646
Therefore, you can build Rust with support for the target by adding it to the
47-
target list in `config.toml`, a sample configuration is shown below.
47+
target list in `bootstrap.toml`, a sample configuration is shown below.
4848

4949
```toml
5050
[build]

src/doc/rustc/src/platform-support/hexagon-unknown-none-elf.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ This target generates PIC ELF binaries.
2828
## Building the target
2929

3030
You can build Rust with support for the target by adding it to the `target`
31-
list in `config.toml`:
31+
list in `bootstrap.toml`:
3232

3333
```toml
3434
[build]

src/doc/rustc/src/platform-support/i686-apple-darwin.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ You'll need the macOS 10.13 SDK shipped with Xcode 9. The location of the SDK
1717
can be passed to `rustc` using the common `SDKROOT` environment variable.
1818

1919
Once you have that, you can build Rust with support for the target by adding
20-
it to the `target` list in `config.toml`:
20+
it to the `target` list in `bootstrap.toml`:
2121

2222
```toml
2323
[build]

src/doc/rustc/src/platform-support/kmc-solid.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ The target can be built by enabling it for a `rustc` build.
3232
target = ["aarch64-kmc-solid_asp3"]
3333
```
3434

35-
Make sure `aarch64-kmc-elf-gcc` is included in `$PATH`. Alternatively, you can use GNU Arm Embedded Toolchain by adding the following to `config.toml`:
35+
Make sure `aarch64-kmc-elf-gcc` is included in `$PATH`. Alternatively, you can use GNU Arm Embedded Toolchain by adding the following to `bootstrap.toml`:
3636

3737
```toml
3838
[target.aarch64-kmc-solid_asp3]

src/doc/rustc/src/platform-support/loongarch-linux.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -65,15 +65,15 @@ These targets are distributed through `rustup`, and otherwise require no
6565
special configuration.
6666

6767
If you need to build your own Rust for some reason though, the targets can be
68-
simply enabled in `config.toml`. For example:
68+
simply enabled in `bootstrap.toml`. For example:
6969

7070
```toml
7171
[build]
7272
target = ["loongarch64-unknown-linux-gnu"]
7373
```
7474

7575
Make sure the LoongArch toolchain binaries are reachable from `$PATH`.
76-
Alternatively, you can explicitly configure the paths in `config.toml`:
76+
Alternatively, you can explicitly configure the paths in `bootstrap.toml`:
7777

7878
```toml
7979
[target.loongarch64-unknown-linux-gnu]

src/doc/rustc/src/platform-support/loongarch-none.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ scripts.
4646
## Building the target
4747

4848
You can build Rust with support for the targets by adding them to the `target`
49-
list in `config.toml`:
49+
list in `bootstrap.toml`:
5050

5151
```toml
5252
[build]

src/doc/rustc/src/platform-support/mips-release-6.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ The following procedure outlines the build process for the MIPS64 R6 target with
6767

6868
### Prerequisite: Disable debuginfo
6969

70-
An LLVM bug makes rustc crash if debug or debug info generation is enabled. You need to edit `config.toml` to disable this:
70+
An LLVM bug makes rustc crash if debug or debug info generation is enabled. You need to edit `bootstrap.toml` to disable this:
7171

7272
```toml
7373
[rust]
@@ -83,7 +83,7 @@ The crate `rustix` may try to link itself against MIPS R2 assembly, resulting in
8383
export RUSTFLAGS="--cfg rustix_use_libc"
8484
```
8585

86-
This will trigger warnings during build, as `-D warnings` is enabled by default. Disable `-D warnings` by editing `config.toml` to append the following:
86+
This will trigger warnings during build, as `-D warnings` is enabled by default. Disable `-D warnings` by editing `bootstrap.toml` to append the following:
8787

8888
```toml
8989
[rust]
@@ -116,7 +116,7 @@ target = ["mipsisa64r6el-unknown-linux-gnuabi64"]
116116

117117
Make sure that `mipsisa64r6el-unknown-linux-gnuabi64-gcc` is available from your executable search path (`$PATH`).
118118

119-
Alternatively, you can specify the directories to all necessary toolchain executables in `config.toml`:
119+
Alternatively, you can specify the directories to all necessary toolchain executables in `bootstrap.toml`:
120120

121121
```toml
122122
[target.mipsisa64r6el-unknown-linux-gnuabi64]

src/doc/rustc/src/platform-support/nto-qnx.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ For conditional compilation, following QNX specific attributes are defined:
124124

125125
## Building the target
126126

127-
1. Create a `config.toml`
127+
1. Create a `bootstrap.toml`
128128

129129
Example content:
130130

src/doc/rustc/src/platform-support/nvptx64-nvidia-cuda.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ What format do binaries use by default? ELF, PE, something else?
3232
## Building the target
3333
3434
If Rust doesn't build the target by default, how can users build it? Can users
35-
just add it to the `target` list in `config.toml`?
35+
just add it to the `target` list in `bootstrap.toml`?
3636
3737
## Building Rust programs
3838

src/doc/rustc/src/platform-support/openharmony.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ linker = "/path/to/x86_64-unknown-linux-ohos-clang.sh"
131131
## Building the target from source
132132

133133
Instead of using `rustup`, you can instead build a rust toolchain from source.
134-
Create a `config.toml` with the following contents:
134+
Create a `bootstrap.toml` with the following contents:
135135

136136
```toml
137137
profile = "compiler"

src/doc/rustc/src/platform-support/pc-windows-gnullvm.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Like with any other Windows target, created binaries are in PE format.
2929

3030
These targets can be easily cross-compiled
3131
using [llvm-mingw](https://github.com/mstorsjo/llvm-mingw) toolchain or [MSYS2 CLANG*](https://www.msys2.org/docs/environments/) environments.
32-
Just fill `[target.*]` sections for both build and resulting compiler and set installation prefix in `config.toml`.
32+
Just fill `[target.*]` sections for both build and resulting compiler and set installation prefix in `bootstrap.toml`.
3333
Then run `./x.py install`.
3434
In my case I had ran `./x.py install --host x86_64-pc-windows-gnullvm --target x86_64-pc-windows-gnullvm` inside MSYS2 MINGW64 shell
3535
so `x86_64-pc-windows-gnu` was my build toolchain.

src/doc/rustc/src/platform-support/powerpc64le-unknown-linux-musl.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The target can be built by enabling it for a `rustc` build.
2323
target = ["powerpc64le-unknown-linux-musl"]
2424
```
2525

26-
Make sure your C compiler is included in `$PATH`, then add it to the `config.toml`:
26+
Make sure your C compiler is included in `$PATH`, then add it to the `bootstrap.toml`:
2727

2828
```toml
2929
[target.powerpc64le-unknown-linux-musl]

src/doc/rustc/src/platform-support/redox.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Redox OS binaries use ELF as file format.
2727

2828
## Building the target
2929

30-
You can build Rust with support for the targets by adding it to the `target` list in `config.toml`. In addition a copy of [relibc] needs to be present in the linker search path.
30+
You can build Rust with support for the targets by adding it to the `target` list in `bootstrap.toml`. In addition a copy of [relibc] needs to be present in the linker search path.
3131

3232
```toml
3333
[build]

src/doc/rustc/src/platform-support/riscv32im-risc0-zkvm-elf.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Calling `extern "C"` on the target uses the C calling convention outlined in the
4343
## Building for the zkVM
4444

4545
Programs for the zkVM could be built by adding it to the `target` list in
46-
`config.toml`. However, we recommend building programs in our starter template
46+
`bootstrap.toml`. However, we recommend building programs in our starter template
4747
generated by the [cargo-risczero] utility and the [risc0-build] crate. This
4848
crate calls `rustc` with `-C "link-arg=-Ttext=` so that it maps the text in the
4949
appropriate location as well as generating variables that represent the ELF and

src/doc/rustc/src/platform-support/riscv32imac-unknown-xous-elf.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The target can be built by enabling it for a `rustc` build.
2424
target = ["riscv32imac-unknown-xous-elf"]
2525
```
2626

27-
Make sure your C compiler is included in `$PATH`, then add it to the `config.toml`:
27+
Make sure your C compiler is included in `$PATH`, then add it to the `bootstrap.toml`:
2828

2929
```toml
3030
[target.riscv32imac-unknown-xous-elf]

src/doc/rustc/src/platform-support/riscv64gc-unknown-linux-gnu.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ These targets are distributed through `rustup`, and otherwise require no
2626
special configuration.
2727

2828
If you need to build your own Rust for some reason though, the targets can be
29-
enabled in `config.toml`. For example:
29+
enabled in `bootstrap.toml`. For example:
3030

3131
```toml
3232
[build]

src/doc/rustc/src/platform-support/riscv64gc-unknown-linux-musl.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The target can be built by enabling it for a `rustc` build.
2222
target = ["riscv64gc-unknown-linux-musl"]
2323
```
2424

25-
Make sure your C compiler is included in `$PATH`, then add it to the `config.toml`:
25+
Make sure your C compiler is included in `$PATH`, then add it to the `bootstrap.toml`:
2626

2727
```toml
2828
[target.riscv64gc-unknown-linux-musl]

src/doc/rustc/src/platform-support/s390x-unknown-linux-gnu.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ This target is distributed through `rustup`, and otherwise requires no
3434
special configuration.
3535

3636
If you need to build your own Rust for some reason though, the target can be
37-
enabled in `config.toml`. For example:
37+
enabled in `bootstrap.toml`. For example:
3838

3939
```toml
4040
[build]

src/doc/rustc/src/platform-support/s390x-unknown-linux-musl.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Because it is Tier 3, Rust does not yet ship pre-compiled artifacts for this
3333
target.
3434

3535
Therefore, you can build Rust with support for the target by adding it to the
36-
target list in `config.toml`, a sample configuration is shown below.
36+
target list in `bootstrap.toml`, a sample configuration is shown below.
3737

3838
```toml
3939
[build]

src/doc/rustc/src/platform-support/sparc-unknown-none-elf.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ considerations for binary layout will require linker options or linker scripts.
3434
## Building the target
3535

3636
You can build Rust with support for the target by adding it to the `target`
37-
list in `config.toml`:
37+
list in `bootstrap.toml`:
3838

3939
```toml
4040
[build]

0 commit comments

Comments
 (0)