rustup: update page, rustup-{show,update,check,default,toolchain,target}: add page (#10642)

pages/common/rustup-check.md

@@ -0,0 +1,8 @@
+# rustup check
+
+> Check for updates to Rust toolchains and `rustup`.
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Check for all updates:
+
+`rustup check`

pages/common/rustup-default.md

@@ -0,0 +1,8 @@
+# rustup default
+
+> Set the default Rust toolchain.
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Switch the default Rust toolchain (see `rustup help toolchain` for more information):
+
+`rustup default {{toolchain}}`

pages/common/rustup-show.md

@@ -0,0 +1,16 @@
+# rustup show
+
+> Show installed toolchains, targets and the version of `rustc`.
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Show all information:
+
+`rustup show`
+
+- Show the active toolchain:
+
+`rustup show active-toolchain`
+
+- Show the rustup data directory:
+
+`rustup show home`

pages/common/rustup-target.md

@@ -0,0 +1,21 @@
+# rustup target
+
+> Modify a toolchain's supported targets.
+> Without the `--toolchain` option `rustup` will use the default toolchain. See `rustup help toolchain` for more information about toolchains.
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Add a target to a toolchain:
+
+`rustup target add --toolchain {{toolchain}} {{target}}`
+
+- Remove a target from a toolchain:
+
+`rustup target remove --toolchain {{toolchain}} {{target}}`
+
+- List available and installed targets for a toolchain:
+
+`rustup target list --toolchain {{toolchain}}`
+
+- List installed targets for a toolchain:
+
+`rustup target list --toolchain {{toolchain}} --installed`

pages/common/rustup-toolchain.md

@@ -0,0 +1,21 @@
+# rustup toolchain
+
+> Manage Rust toolchains.
+> See `rustup help toolchain` for more information about toolchains.
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Install or update a given toolchain:
+
+`rustup install {{toolchain}}`
+
+- Uninstall a toolchain:
+
+`rustup uninstall {{toolchain}}`
+
+- List installed toolchains:
+
+`rustup list`
+
+- Create a custom toolchain by symlinking to a directory:
+
+`rustup link {{custom_toolchain_name}} {{path/to/directory}}`

pages/common/rustup-update.md

@@ -0,0 +1,12 @@
+# rustup update
+
+> Update Rust toolchains and `rustup` itself (if not installed using a package manager).
+> More information: <https://rust-lang.github.io/rustup>.
+
+- Update all installed toolchains and `rustup`:
+
+`rustup update`
+
+- Install or update a specific toolchain (see `rustup help toolchain` for more information):
+
+`rustup update {{toolchain}}`

pages/common/rustup.md

@@ -1,8 +1,8 @@
 # rustup
 
-> Rust toolchain installer.
 > Install, manage, and update Rust toolchains.
-> More information: <https://github.com/rust-lang/rustup.rs>.
+> Some subcommands, such as `toolchain`, `target`, `update`, etc. have their own usage documentation.
+> More information: <https://rust-lang.github.io/rustup>.
 
 - Install the nightly toolchain for your system:
 
@@ -12,7 +12,7 @@
 
 `rustup default nightly`
 
-- Use the nightly toolchain when inside the current project, but leave global settings unchanged:
+- Use the nightly toolchain when inside the current project but leave global settings unchanged:
 
 `rustup override set nightly`
 
@@ -24,10 +24,10 @@
 
 `rustup show`
 
-- Run cargo build with a certain toolchain:
+- Run `cargo build` with a certain toolchain:
 
-`rustup run {{toolchain_name}} cargo build`
+`rustup run {{toolchain}} cargo build`
 
-- Open the local rust documentation in the default web browser:
+- Open the local Rust documentation in the default web browser:
 
 `rustup doc`