about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorAndrew Dona-Couch -- GitHub drop ICE <github@couchand.com>2022-06-06 19:37:50 -0400
committerGitHub <noreply@github.com>2022-06-07 08:37:50 +0900
commit46d48d8d72cfd28e259535762c501bdca285214b (patch)
tree3391c68a156927aa697bd7ba45ce592542d6f81f /src/doc/rustc-dev-guide
parent93771d84e0f5113a3ff8418541e34eca05858a8f (diff)
downloadrust-46d48d8d72cfd28e259535762c501bdca285214b.tar.gz
rust-46d48d8d72cfd28e259535762c501bdca285214b.zip
Clarify cargo fallback behavior for rustup link (#1273)
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/building/how-to-build-and-run.md6
1 files changed, 6 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/building/how-to-build-and-run.md b/src/doc/rustc-dev-guide/src/building/how-to-build-and-run.md
index dd997c81415..9ef43e341ce 100644
--- a/src/doc/rustc-dev-guide/src/building/how-to-build-and-run.md
+++ b/src/doc/rustc-dev-guide/src/building/how-to-build-and-run.md
@@ -233,6 +233,12 @@ The rustup toolchain points to the specified toolchain compiled in your `build`
 so the rustup toolchain will be updated whenever `x.py build` or `x.py test` are run for
 that toolchain/stage.
 
+**Note:** the toolchain we've built does not include `cargo`.  In this case, `rustup` will
+fall back to using `cargo` from the installed `nightly`, `beta`, or `stable` toolchain
+(in that order).  If you need to use unstable `cargo` flags, be sure to run
+`rustup install nightly` if you haven't already.  See the
+[rustup documentation on custom toolchains](https://rust-lang.github.io/rustup/concepts/toolchains.html#custom-toolchains).
+
 ## Other `x.py` commands
 
 Here are a few other useful `x.py` commands. We'll cover some of them in detail