From f9c9185f36c40fa2a1d7e7af86515ca9e5a90699 Mon Sep 17 00:00:00 2001
From: Lin Yihai <linyihai@huawei.com>
Date: Tue, 9 Jan 2024 00:57:29 +0800
Subject: [PATCH] doc: add `public` info in `cargo-add` man page.

---
 src/bin/cargo/commands/add.rs             |  8 ++++++--
 src/doc/man/cargo-add.md                  | 12 ++++++++++++
 src/doc/man/generated_txt/cargo-add.txt   | 12 ++++++++++++
 src/doc/src/commands/cargo-add.md         | 10 ++++++++++
 src/etc/man/cargo-add.1                   | 14 ++++++++++++++
 tests/testsuite/cargo_add/help/stdout.log |  6 ++++++
 6 files changed, 60 insertions(+), 2 deletions(-)

diff --git a/src/bin/cargo/commands/add.rs b/src/bin/cargo/commands/add.rs
index 55a074282024..f408843b9423 100644
--- a/src/bin/cargo/commands/add.rs
+++ b/src/bin/cargo/commands/add.rs
@@ -67,14 +67,18 @@ The package will be removed from your features.")
                 .conflicts_with("build")
                 .long_help("Mark the dependency as public
 
-The dependency can be referenced in your library's public API."),
+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")
                 .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)
diff --git a/src/doc/man/cargo-add.md b/src/doc/man/cargo-add.md
index d3a62900a062..202dbd5efb3b 100644
--- a/src/doc/man/cargo-add.md
+++ b/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}}
diff --git a/src/doc/man/generated_txt/cargo-add.txt b/src/doc/man/generated_txt/cargo-add.txt
index 3bd4bd5aa91a..0c1bd49a8ddb 100644
--- a/src/doc/man/generated_txt/cargo-add.txt
+++ b/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>.
diff --git a/src/doc/src/commands/cargo-add.md b/src/doc/src/commands/cargo-add.md
index 68b7c4c364c6..66dc13ee9e46 100644
--- a/src/doc/src/commands/cargo-add.md
+++ b/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>
 
diff --git a/src/etc/man/cargo-add.1 b/src/etc/man/cargo-add.1
index 4e8b685667d6..0f49d521adbb 100644
--- a/src/etc/man/cargo-add.1
+++ b/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>\&.
diff --git a/tests/testsuite/cargo_add/help/stdout.log b/tests/testsuite/cargo_add/help/stdout.log
index d2931ae9cd41..250abed32943 100644
--- a/tests/testsuite/cargo_add/help/stdout.log
+++ b/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