doc: add public info in cargo-add man page.

Author: linyihai

src/bin/cargo/commands/add.rs

@@ -62,19 +62,23 @@ The package name will be exposed as feature of your crate.")
 The package will be removed from your features.")
                 .conflicts_with("dev")
                 .overrides_with("optional"),
-            flag("public", "Mark the dependency as public")
+            flag("public", "Mark the dependency as public (unstable)")
                 .conflicts_with("dev")
                 .conflicts_with("build")
                 .long_help("Mark the dependency as public
 
-The dependency can be referenced in your library's public API."),
-            flag("no-public", "Mark the dependency as private")
+The dependency can be referenced in your library's public API.
+
+Unstable (nightly-only) <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency> "),
+            flag("no-public", "Mark the dependency as private (unstable)")
                 .conflicts_with("dev")
                 .conflicts_with("build")
                 .overrides_with("public")
                 .long_help("Mark the dependency as private
 
-While you can use the crate in your implementation, it cannot be referenced in your public API."),
+While you can use the crate in your implementation, it cannot be referenced in your public API.
+
+Unstable (nightly-only) <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency>"),
             clap::Arg::new("rename")
                 .long("rename")
                 .action(ArgAction::Set)

src/doc/man/cargo-add.md

@@ -107,6 +107,18 @@ Mark the dependency as [optional](../reference/features.html#optional-dependenci
 Mark the dependency as [required](../reference/features.html#optional-dependencies).
 {{/option}}
 
+{{#option "`--public`" }}
+Mark the dependency as public. 
+
+[Unstable (nightly-only)](../reference/unstable.html#public-dependency)
+{{/option}}
+
+{{#option "`--no-public`" }}
+Mark the dependency as private. 
+
+[Unstable (nightly-only)](../reference/unstable.html#public-dependency)
+{{/option}}
+
 {{#option "`--no-default-features`" }}
 Disable the [default features](../reference/features.html#dependency-features).
 {{/option}}

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

@@ -96,6 +96,18 @@ OPTIONS
            Mark the dependency as required
            <https://doc.rust-lang.org/cargo/reference/features.html#optional-dependencies>.
 
+       --public
+           Mark the dependency as public.
+
+           Unstable (nightly-only)
+           <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency>
+
+       --no-public
+           Mark the dependency as private.
+
+           Unstable (nightly-only)
+           <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency>
+
        --no-default-features
            Disable the default features
            <https://doc.rust-lang.org/cargo/reference/features.html#dependency-features>.

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

@@ -107,6 +107,16 @@ which is defined by the <code>registry.default</code> config key which defaults
 <dd class="option-desc">Mark the dependency as <a href="../reference/features.html#optional-dependencies">required</a>.</dd>
 
 
+<dt class="option-term" id="option-cargo-add---public"><a class="option-anchor" href="#option-cargo-add---public"></a><code>--public</code></dt>
+<dd class="option-desc">Mark the dependency as public. </p>
+<p><a href="../reference/unstable.html#public-dependency">Unstable (nightly-only)</a></dd>
+
+
+<dt class="option-term" id="option-cargo-add---no-public"><a class="option-anchor" href="#option-cargo-add---no-public"></a><code>--no-public</code></dt>
+<dd class="option-desc">Mark the dependency as private. </p>
+<p><a href="../reference/unstable.html#public-dependency">Unstable (nightly-only)</a></dd>
+
+
 <dt class="option-term" id="option-cargo-add---no-default-features"><a class="option-anchor" href="#option-cargo-add---no-default-features"></a><code>--no-default-features</code></dt>
 <dd class="option-desc">Disable the <a href="../reference/features.html#dependency-features">default features</a>.</dd>
 

src/etc/man/cargo-add.1

@@ -121,6 +121,20 @@ Mark the dependency as \fIoptional\fR <https://doc.rust\-lang.org/cargo/referenc
 Mark the dependency as \fIrequired\fR <https://doc.rust\-lang.org/cargo/reference/features.html#optional\-dependencies>\&.
 .RE
 .sp
+\fB\-\-public\fR
+.RS 4
+Mark the dependency as public. 
+.sp
+\fIUnstable (nightly\-only)\fR <https://doc.rust\-lang.org/cargo/reference/unstable.html#public\-dependency>
+.RE
+.sp
+\fB\-\-no\-public\fR
+.RS 4
+Mark the dependency as private. 
+.sp
+\fIUnstable (nightly\-only)\fR <https://doc.rust\-lang.org/cargo/reference/unstable.html#public\-dependency>
+.RE
+.sp
 \fB\-\-no\-default\-features\fR
 .RS 4
 Disable the \fIdefault features\fR <https://doc.rust\-lang.org/cargo/reference/features.html#dependency\-features>\&.

tests/testsuite/cargo_add/help/stdout.log

@@ -36,12 +36,18 @@ Options:
           Mark the dependency as public
 
           The dependency can be referenced in your library's public API.
+          
+          Unstable (nightly-only)
+          <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency>
 
       --no-public
           Mark the dependency as private
 
           While you can use the crate in your implementation, it cannot be referenced in your public
           API.
+          
+          Unstable (nightly-only)
+          <https://doc.rust-lang.org/cargo/reference/unstable.html#public-dependency>
 
       --rename <NAME>
           Rename the dependency