|
740 | 740 | # result (broken, compiling, testing) into this JSON file.
|
741 | 741 | #rust.save-toolstates = <none> (path)
|
742 | 742 |
|
743 |
| -# This is an array of the codegen backends that will be compiled for the rustc |
744 |
| -# that's being compiled. The default is to only build the LLVM codegen backend, |
745 |
| -# and currently the only standard options supported are `"llvm"`, `"cranelift"` |
746 |
| -# and `"gcc"`. The first backend in this list will be used as default by rustc |
747 |
| -# when no explicit backend is specified. |
| 743 | +# This array serves three distinct purposes: |
| 744 | +# - Backends in this list will be automatically compiled and included in the sysroot of each |
| 745 | +# rustc compiled by bootstrap. |
| 746 | +# - The first backend in this list will be configured as the **default codegen backend** by each |
| 747 | +# rustc compiled by bootstrap. In other words, if the first backend is e.g. cranelift, then when |
| 748 | +# we build a stage 1 rustc, it will by default compile Rust programs using the Cranelift backend. |
| 749 | +# This also means that stage 2 rustc would get built by the Cranelift backend. |
| 750 | +# - Running `x dist` (without additional arguments, or with `--include-default-paths`) will produce |
| 751 | +# a dist component/tarball for the Cranelift backend if it is included in this array. |
| 752 | +# |
| 753 | +# Note that the LLVM codegen backend is special and will always be built and distributed. |
| 754 | +# |
| 755 | +# Currently, the only standard options supported here are `"llvm"`, `"cranelift"` and `"gcc"`. |
748 | 756 | #rust.codegen-backends = ["llvm"]
|
749 | 757 |
|
750 | 758 | # Indicates whether LLD will be compiled and made available in the sysroot for rustc to execute, and
|
|
0 commit comments