Regenerate man pages after documenting cumulative --no-deps behavior

Author: ojuschugh1

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

@@ -22,6 +22,15 @@ OPTIONS
        --no-deps
            Do not build documentation for dependencies.
 
+           Note: Documentation is cumulative. If you’ve already run cargo doc
+           (including dependency docs), and later run cargo doc --no-deps,
+           Cargo will skip deleting or rebuilding those old dependency docs. To
+           remove them, you can either:
+
+           1. Run cargo clean --doc before cargo doc --no-deps, or
+
+           2. Manually delete the unwanted folders under target/doc/.
+
        --document-private-items
            Include non-public items in the documentation. This will be enabled
            by default if documenting a binary target.

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

@@ -26,18 +26,16 @@ option.</dd>
 
 
 <dt class="option-term" id="option-cargo-doc---no-deps"><a class="option-anchor" href="#option-cargo-doc---no-deps"></a><code>--no-deps</code></dt>
-<dd class="option-desc">
-  Do not build documentation for dependencies.
-
-  <p><strong>Note:</strong> Cargo keeps docs cumulatively. If you’ve already run
-  <code>cargo doc</code> (which generated dependency docs), then later run
-  <code>cargo doc --no-deps</code>, Cargo will skip rebuilding (and won’t delete)
-  those existing docs. To truly remove old dependency docs, either:
-
-  1. Run <code>cargo clean --doc</code> before <code>cargo doc --no-deps</code>, or  
-  2. Manually delete the unwanted folders under <code>target/doc/</code>.
-  </p>
-</dd>
+<dd class="option-desc">Do not build documentation for dependencies.</p>
+<p><strong>Note:</strong> Documentation is <em>cumulative</em>. If you’ve already run
+<code>cargo doc</code> (including dependency docs), and later run
+<code>cargo doc --no-deps</code>, Cargo will skip deleting or rebuilding those
+old dependency docs. To remove them, you can either:</p>
+<ol>
+<li>Run <code>cargo clean --doc</code> before <code>cargo doc --no-deps</code>, or</li>
+<li>Manually delete the unwanted folders under <code>target/doc/</code>.</li>
+</ol></dd>
+
 
 <dt class="option-term" id="option-cargo-doc---document-private-items"><a class="option-anchor" href="#option-cargo-doc---document-private-items"></a><code>--document-private-items</code></dt>
 <dd class="option-desc">Include non-public items in the documentation. This will be enabled by default if documenting a binary target.</dd>

src/etc/man/cargo-doc.1

@@ -24,6 +24,19 @@ option.
 \fB\-\-no\-deps\fR
 .RS 4
 Do not build documentation for dependencies.
+.sp
+\fBNote:\fR Documentation is \fIcumulative\fR\&. If you\[cq]ve already run
+\fBcargo doc\fR (including dependency docs), and later run
+\fBcargo doc \-\-no\-deps\fR, Cargo will skip deleting or rebuilding those
+old dependency docs. To remove them, you can either:
+.sp
+.RS 4
+\h'-04' 1.\h'+01'Run \fBcargo clean \-\-doc\fR before \fBcargo doc \-\-no\-deps\fR, or
+.RE
+.sp
+.RS 4
+\h'-04' 2.\h'+01'Manually delete the unwanted folders under \fBtarget/doc/\fR\&.
+.RE
 .RE
 .sp
 \fB\-\-document\-private\-items\fR