From cbfdb997d9615d536333c10c6995105e5eb6d0ba Mon Sep 17 00:00:00 2001 From: hi-rustin Date: Thu, 17 Jun 2021 22:41:11 +0800 Subject: [PATCH 1/2] Document automatic installation behavior via `rustup show` --- doc/src/overrides.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/src/overrides.md b/doc/src/overrides.md index 5c53ac6a99..f8cb3759d6 100644 --- a/doc/src/overrides.md +++ b/doc/src/overrides.md @@ -19,7 +19,9 @@ the directory tree toward the filesystem root, and a `rust-toolchain.toml` file that is closer to the current directory will be preferred over a directory override that is further away. -To verify which toolchain is active use `rustup show`. +To verify which toolchain is active, you can use `rustup show`, +which will also try to install the corresponding +toolchain if the current one has not been installed according to the above rules. [toolchain]: concepts/toolchains.md [toolchain override shorthand]: #toolchain-override-shorthand From 0e9375c6c75c8ec2c0305cc2db60a4837b72cfa9 Mon Sep 17 00:00:00 2001 From: hi-rustin Date: Sun, 20 Jun 2021 15:51:40 +0800 Subject: [PATCH 2/2] Add note and link to the issue --- doc/src/overrides.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/src/overrides.md b/doc/src/overrides.md index f8cb3759d6..cb96ae4cc0 100644 --- a/doc/src/overrides.md +++ b/doc/src/overrides.md @@ -22,6 +22,7 @@ override that is further away. To verify which toolchain is active, you can use `rustup show`, which will also try to install the corresponding toolchain if the current one has not been installed according to the above rules. +(Please note that this behavior is subject to change, as detailed in issue [#1397].) [toolchain]: concepts/toolchains.md [toolchain override shorthand]: #toolchain-override-shorthand @@ -143,3 +144,4 @@ rustup default nightly-2020-07-27 ``` [installed]: installation/index.md +[#1397]: https://github.com/rust-lang/rustup/issues/1397