Minor tweaks and some links.

Author: ehuss

doc/src/environment-variables.md

@@ -4,8 +4,8 @@
   root `rustup` folder, used for storing installed toolchains and
   configuration options.
 
-- `RUSTUP_TOOLCHAIN` (default: none) If set, will override the toolchain used
-  for all rust tool invocations. A toolchain with this name should be
+- `RUSTUP_TOOLCHAIN` (default: none) If set, will [override] the toolchain
+  used for all rust tool invocations. A toolchain with this name should be
   installed, or invocations will fail.
 
 - `RUSTUP_DIST_SERVER` (default: `https://static.rust-lang.org`) Sets the root
@@ -26,10 +26,7 @@
 
 - `RUSTUP_TRACE_DIR` *unstable* (default: no tracing) Enables tracing and
   determines the directory that traces will be written too. Traces are of the
-  form PID.trace. Traces can be read by the Catapult project [tracing
-  viewer][tv].
-
-  [tv]: (https://github.com/catapult-project/catapult/blob/master/tracing/README.md)
+  form PID.trace. Traces can be read by the Catapult project [tracing viewer].
 
 - `RUSTUP_UNPACK_RAM` *unstable* (default 400M, min 100M) Caps the amount of
   RAM `rustup` will use for IO tasks while unpacking.
@@ -43,4 +40,6 @@
   feature sacrifices some transactions protections and may be removed at any
   point. Linux only.
 
-  [dc]: (https://docs.docker.com/storage/storagedriver/overlayfs-driver/#modifying-files-or-directories)
+[dc]: https://docs.docker.com/storage/storagedriver/overlayfs-driver/#modifying-files-or-directories
+[override]: overrides.md
+[tracing viewer]: https://github.com/catapult-project/catapult/blob/master/tracing/README.md

doc/src/examples.md

@@ -2,13 +2,13 @@
 
 Command                                                     | Description
 ----------------------------------------------------------- | ------------------------------------------------------------
-`rustup default nightly`                                    | Set the default toolchain to the latest nightly
-`rustup set profile minimal`                                | Set the default "profile" (see [profiles](#profiles))
-`rustup target list`                                        | List all available targets for the active toolchain
+`rustup default nightly`                                    | Set the [default toolchain] to the latest nightly
+`rustup set profile minimal`                                | Set the default [profile]
+`rustup target list`                                        | List all available [targets] for the active toolchain
 `rustup target add arm-linux-androideabi`                   | Install the Android target
 `rustup target remove arm-linux-androideabi`                | Remove the Android target
 `rustup run nightly rustc foo.rs`                           | Run the nightly regardless of the active toolchain
-`rustc +nightly foo.rs`                                     | Shorthand way to run a nightly compiler
+`rustc +nightly foo.rs`                                     | [Shorthand] way to run a nightly compiler
 `rustup run nightly bash`                                   | Run a shell configured for the nightly compiler
 `rustup default stable-msvc`                                | On Windows, use the MSVC toolchain instead of GNU
 `rustup override set nightly-2015-04-01`                    | For the current directory, use a nightly from a specific date
@@ -17,3 +17,8 @@ Command                                                     | Description
 `rustup toolchain uninstall nightly`                        | Uninstall a given toolchain
 `rustup toolchain help`                                     | Show the `help` page for a subcommand (like `toolchain`)
 `rustup man cargo`                                          | \(*Unix only*\) View the man page for a given command (like `cargo`)
+
+[default toolchain]: overrides.md#default-toolchain
+[profile]: concepts/profiles.md
+[shorthand]: overrides.md#toolchain-override-shorthand
+[targets]: cross-compilation.md