fixed documentation and regenaration of the pages

Author: ojuschugh1

src/doc/man/cargo-doc.md

@@ -16,6 +16,8 @@ cargo-doc --- Build a package's documentation
 Build the documentation for the local package and all dependencies. The output
 is placed in `target/doc` in rustdoc's usual format.
 
+Documentation generation is cumulative: existing doc files in the target directory are preserved across different cargo doc invocations. To remove existing generated docs, pass --doc to {{man "cargo-clean" 1}}.
+
 ## OPTIONS
 
 ### Documentation Options

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

@@ -10,6 +10,10 @@ DESCRIPTION
        Build the documentation for the local package and all dependencies. The
        output is placed in target/doc in rustdoc’s usual format.
 
+       Documentation generation is cumulative: existing doc files in the target
+       directory are preserved across different cargo doc invocations. To
+       remove existing generated docs, pass –doc to cargo-clean(1).
+
 OPTIONS
    Documentation Options
        --open

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

@@ -12,6 +12,8 @@ cargo-doc --- Build a package's documentation
 Build the documentation for the local package and all dependencies. The output
 is placed in `target/doc` in rustdoc's usual format.
 
+Documentation generation is cumulative: existing doc files in the target directory are preserved across different cargo doc invocations. To remove existing generated docs, pass --doc to [cargo-clean(1)](cargo-clean.html).
+
 ## OPTIONS
 
 ### Documentation Options

src/etc/man/cargo-doc.1

@@ -10,6 +10,8 @@ cargo\-doc \[em] Build a package\[cq]s documentation
 .SH "DESCRIPTION"
 Build the documentation for the local package and all dependencies. The output
 is placed in \fBtarget/doc\fR in rustdoc\[cq]s usual format.
+.sp
+Documentation generation is cumulative: existing doc files in the target directory are preserved across different cargo doc invocations. To remove existing generated docs, pass \[en]doc to \fBcargo\-clean\fR(1).
 .SH "OPTIONS"
 .SS "Documentation Options"
 .sp