Auto merge of #10153 - ehuss:fix-profile-docs, r=alexcrichton

Fix some profile documentation. The `test` and `bench` sections had wrong information about which profile is used. This also has some changes to try to format and clarify selection a little.
rust-lang · Dec 13, 2021 · 85d1462 · 85d1462
2 parents 3aaa8f9 + 1ddf453
commit 85d1462
Showing 1 changed file with 14 additions and 12 deletions.
diff --git a/src/doc/src/reference/profiles.md b/src/doc/src/reference/profiles.md
@@ -266,15 +266,13 @@ rpath = false
 
 #### test
 
-The `test` profile is used for building tests, or when benchmarks are built in
-debug mode with `cargo build`. By default, the `test` profile inherits the
-settings from the [`dev`](#dev) profile.
+The `test` profile is the default profile used by [`cargo test`].
+The `test` profile inherits the settings from the [`dev`](#dev) profile.
 
 #### bench
 
-The `bench` profile is used for building benchmarks, or when tests are built
-with the `--release` flag. By default, the `bench` profile inherits the
-settings from the [`release`](#release) profile.
+The `bench` profile is the default profile used by [`cargo bench`].
+The `bench` profile inherits the settings from the [`release`](#release) profile.
 
 #### Build Dependencies
 
@@ -293,7 +291,7 @@ codegen-units = 256
 ```
 
 Build dependencies otherwise inherit settings from the active profile in use, as
-described below.
+described in [Profile selection](#profile-selection).
 
 ### Custom profiles
 
@@ -331,11 +329,15 @@ The profile used depends on the command, the command-line flags like
 `--release` or `--profile`, and the package (in the case of
 [overrides](#overrides)). The default profile if none is specified is:
 
-* Build commands like [`cargo build`], [`cargo rustc`], [`cargo check`], and
-[`cargo run`]: [`dev` profile](#dev)
-* [`cargo test`]: [`test` profile](#test)
-* [`cargo bench`]: [`bench` profile](#bench)
-* [`cargo install`]: [`release` profile](#release)
+| Command | Default Profile |
+|---------|-----------------|
+| [`cargo run`], [`cargo build`],<br>[`cargo check`], [`cargo rustc`] | [`dev` profile](#dev) |
+| [`cargo test`] | [`test` profile](#test)
+| [`cargo bench`] | [`bench` profile](#bench)
+| [`cargo install`] | [`release` profile](#release)
+
+You can switch to a different profile using the `--profile=NAME` option which will used the given profile.
+The `--release` flag is equivalent to `--profile=release`.
 
 The selected profile applies to all Cargo targets, 
 including [library](./cargo-targets.md#library),