docs: rust: clarify what 'rustup override' does
authorTrevor Gross <tmgross@umich.edu>
Thu, 3 Aug 2023 06:04:37 +0000 (02:04 -0400)
committerMiguel Ojeda <ojeda@kernel.org>
Sun, 20 Aug 2023 22:36:41 +0000 (00:36 +0200)
The behavior of 'rustup override' is not very well known. Add a small
note about what it does, so users have a better understanding of how it
affects their system toolchain (i.e., it does not affect system
toolchain and only sets a directory-specific override).

Signed-off-by: Trevor Gross <tmgross@umich.edu>
Reviewed-by: Martin Rodriguez Reboredo <yakoyoku@gmail.com>
Reviewed-by: Alice Ryhl <aliceryhl@google.com>
Link: https://lore.kernel.org/r/20230803060437.12157-3-tmgross@umich.edu
[ Undid the `:` to `::` change. ]
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
Documentation/rust/quick-start.rst

index a0a47a6f216b56cfaa53a292c4d481fa2d0214e7..f382914f41917a6c1fa12e5f5242341af677fc56 100644 (file)
@@ -38,7 +38,9 @@ and run::
 
        rustup override set $(scripts/min-tool-version.sh rustc)
 
-Otherwise, fetch a standalone installer from:
+This will configure your working directory to use the correct version of
+``rustc`` without affecting your default toolchain. If you are not using
+``rustup``, fetch a standalone installer from:
 
        https://forge.rust-lang.org/infra/other-installation-methods.html#standalone