Auto merge of #11826 - weihanglo:cargo-add-target, r=epage

Notice for potential unexpected shell expansions in help text of `cargo-add`

Author: bors

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}}
 
-
-</dl>
-
 ### 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}}

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}}

src/doc/man/generated_txt/cargo-add.txt

@@ -76,7 +76,8 @@ OPTIONS
            Add as a dependency to the given target platform
            <https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#platform-specific-dependencies>.
 
-</dl>
+           To avoid unexpected shell expansions, you may use quotes around each
+           target, e.g., --target 'cfg(unix)'.
 
    Dependency options
        --dry-run
@@ -226,6 +227,10 @@ EXAMPLES
 
               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-remove(1)
 

src/doc/man/generated_txt/cargo-remove.txt

@@ -23,6 +23,9 @@ OPTIONS
            Remove as a dependency to the given target platform
            <https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html#platform-specific-dependencies>.
 
+           To avoid unexpected shell expansions, you may use quotes around each
+           target, e.g., --target 'cfg(unix)'.
+
    Miscellaneous Options
        --dry-run
            Don’t actually write to the manifest.

src/doc/src/commands/cargo-add.md

@@ -86,10 +86,8 @@ which is defined by the <code>registry.default</code> config key which defaults
 
 
 <dt class="option-term" id="option-cargo-add---target"><a class="option-anchor" href="#option-cargo-add---target"></a><code>--target</code> <em>target</em></dt>
-<dd class="option-desc">Add as a dependency to the <a href="../reference/specifying-dependencies.html#platform-specific-dependencies">given target platform</a>.</dd>
-
-
-</dl>
+<dd class="option-desc">Add as a dependency to the <a href="../reference/specifying-dependencies.html#platform-specific-dependencies">given target platform</a>.</p>
+<p>To avoid unexpected shell expansions, you may use quotes around each target, e.g., <code>--target 'cfg(unix)'</code>.</dd>
 
 
 </dl>
@@ -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)

src/doc/src/commands/cargo-remove.md

@@ -29,7 +29,8 @@ Remove one or more dependencies from a `Cargo.toml` manifest.
 
 
 <dt class="option-term" id="option-cargo-remove---target"><a class="option-anchor" href="#option-cargo-remove---target"></a><code>--target</code> <em>target</em></dt>
-<dd class="option-desc">Remove as a dependency to the <a href="../reference/specifying-dependencies.html#platform-specific-dependencies">given target platform</a>.</dd>
+<dd class="option-desc">Remove as a dependency to the <a href="../reference/specifying-dependencies.html#platform-specific-dependencies">given target platform</a>.</p>
+<p>To avoid unexpected shell expansions, you may use quotes around each target, e.g., <code>--target 'cfg(unix)'</code>.</dd>
 
 
 </dl>

src/etc/man/cargo-add.1

@@ -96,8 +96,9 @@ Add as a \fIbuild dependency\fR <https://doc.rust\-lang.org/cargo/reference/spec
 \fB\-\-target\fR \fItarget\fR
 .RS 4
 Add as a dependency to the \fIgiven target platform\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html#platform\-specific\-dependencies>\&.
+.sp
+To avoid unexpected shell expansions, you may use quotes around each target, e.g., \fB\-\-target 'cfg(unix)'\fR\&.
 .RE
-</dl>
 .SS "Dependency options"
 .sp
 \fB\-\-dry\-run\fR
@@ -308,5 +309,15 @@ cargo add serde serde_json \-F serde/derive
 .fi
 .RE
 .RE
+.sp
+.RS 4
+\h'-04' 5.\h'+01'Add \fBwindows\fR as a platform specific dependency on \fBcfg(windows)\fR
+.sp
+.RS 4
+.nf
+cargo add windows \-\-target 'cfg(windows)'
+.fi
+.RE
+.RE
 .SH "SEE ALSO"
 \fBcargo\fR(1), \fBcargo\-remove\fR(1)

src/etc/man/cargo-remove.1

@@ -25,6 +25,8 @@ Remove as a \fIbuild dependency\fR <https://doc.rust\-lang.org/cargo/reference/s
 \fB\-\-target\fR \fItarget\fR
 .RS 4
 Remove as a dependency to the \fIgiven target platform\fR <https://doc.rust\-lang.org/cargo/reference/specifying\-dependencies.html#platform\-specific\-dependencies>\&.
+.sp
+To avoid unexpected shell expansions, you may use quotes around each target, e.g., \fB\-\-target 'cfg(unix)'\fR\&.
 .RE
 .SS "Miscellaneous Options"
 .sp