diff --git a/src/doc/man/cargo-add.md b/src/doc/man/cargo-add.md
index c9bb2376e0c..c441a82b2ff 100644
--- a/src/doc/man/cargo-add.md
+++ b/src/doc/man/cargo-add.md
@@ -81,13 +81,12 @@ Add as a [build dependency](../reference/specifying-dependencies.html#build-depe
{{#option "`--target` _target_" }}
Add as a dependency to the [given target platform](../reference/specifying-dependencies.html#platform-specific-dependencies).
+
+To avoid unexpected shell expansions, you may use quotes around each target, e.g., `--target 'cfg(unix)'`.
{{/option}}
{{/options}}
-
-
-
### Dependency options
{{#options}}
@@ -169,5 +168,9 @@ Add dependencies to only the specified package.
cargo add serde serde_json -F serde/derive
+5. Add `windows` as a platform specific dependency on `cfg(windows)`
+
+ cargo add windows --target 'cfg(windows)'
+
## SEE ALSO
{{man "cargo" 1}}, {{man "cargo-remove" 1}}
diff --git a/src/doc/man/cargo-remove.md b/src/doc/man/cargo-remove.md
index 0722e6e53de..e38589ccb08 100644
--- a/src/doc/man/cargo-remove.md
+++ b/src/doc/man/cargo-remove.md
@@ -30,6 +30,8 @@ Remove as a [build dependency](../reference/specifying-dependencies.html#build-d
{{#option "`--target` _target_" }}
Remove as a dependency to the [given target platform](../reference/specifying-dependencies.html#platform-specific-dependencies).
+
+To avoid unexpected shell expansions, you may use quotes around each target, e.g., `--target 'cfg(unix)'`.
{{/option}}
{{/options}}
diff --git a/src/doc/man/generated_txt/cargo-add.txt b/src/doc/man/generated_txt/cargo-add.txt
index 8cd30eba335..0bf279df1e5 100644
--- a/src/doc/man/generated_txt/cargo-add.txt
+++ b/src/doc/man/generated_txt/cargo-add.txt
@@ -76,7 +76,8 @@ OPTIONS
Add as a dependency to the given target platform
registry.default
config key which defaults
--target
target
To avoid unexpected shell expansions, you may use quotes around each target, e.g., --target 'cfg(unix)'
.
@@ -272,5 +270,9 @@ details on environment variables that Cargo reads.
cargo add serde serde_json -F serde/derive
+5. Add `windows` as a platform specific dependency on `cfg(windows)`
+
+ cargo add windows --target 'cfg(windows)'
+
## SEE ALSO
[cargo(1)](cargo.html), [cargo-remove(1)](cargo-remove.html)
diff --git a/src/doc/src/commands/cargo-remove.md b/src/doc/src/commands/cargo-remove.md
index 29989815a7b..61718af5fa4 100644
--- a/src/doc/src/commands/cargo-remove.md
+++ b/src/doc/src/commands/cargo-remove.md
@@ -29,7 +29,8 @@ Remove one or more dependencies from a `Cargo.toml` manifest.
--target
targetTo avoid unexpected shell expansions, you may use quotes around each target, e.g., --target 'cfg(unix)'
.