Fix DESCRIPTION formatting, regenerate docs

Author: ojuschugh1

src/doc/man/cargo-doc.md

@@ -31,6 +31,14 @@ option.
 
 {{#option "`--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/`.
 {{/option}}
 
 {{#option "`--document-private-items`" }}

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,7 +26,15 @@ 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.</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>

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