@@ -83,9 +83,6 @@ a directory, the latter is used for backwards compatibility. The files use the
83
83
``` toml
84
84
[toolchain ]
85
85
channel = " nightly-2020-07-10"
86
- # or
87
- path = " /path/to/local/toolchain"
88
-
89
86
components = [ " rustfmt" , " rustc-dev" ]
90
87
targets = [ " wasm32-unknown-unknown" , " thumbv2-none-eabi" ]
91
88
profile = " minimal"
@@ -107,9 +104,19 @@ The toolchains named in these files have a more restricted form than `rustup`
107
104
toolchains generally, and may only contain the names of the three release
108
105
channels, 'stable', 'beta', 'nightly', Rust version numbers, like '1.0.0', and
109
106
optionally an archive date, like 'nightly-2017-01-01'. They may not name
110
- custom toolchains, nor host-specific toolchains, except by giving the
111
- ` path ` to said toolchain directly. A relative ` path ` is resolved
112
- relative to the location of the ` rust-toolchain.toml ` file.
107
+ custom toolchains, nor host-specific toolchains. To use a custom local
108
+ toolchain, you can instead use a ` path ` toolchain:
109
+
110
+ ``` toml
111
+ [toolchain ]
112
+ path = " /path/to/local/toolchain"
113
+ ```
114
+
115
+ Since a ` path ` directive directly names a local toolchain, other options
116
+ like ` components ` , ` targets ` , and ` profile ` have no effect. ` channel `
117
+ and ` path ` are mutually exclusive, since a ` path ` already points to a
118
+ specific toolchain. A relative ` path ` is resolved relative to the
119
+ location of the ` rust-toolchain.toml ` file.
113
120
114
121
## Default toolchain
115
122
0 commit comments