doc: highlight `--doc` only applied on lib target

diff --git a/src/doc/man/cargo-test.md b/src/doc/man/cargo-test.md
index 6c1ea88fa96b66260776e532165a6bb7c10033d8..06690e88cc7b636b2ae25d6d45eff57e7fb608ff 100644 (file)
--- a/src/doc/man/cargo-test.md
+++ b/src/doc/man/cargo-test.md
@@ -38,9 +38,9 @@ manifest settings, in which case your code will need to provide its own `main`
 function to handle running tests.
 
 Documentation tests are also run by default, which is handled by `rustdoc`. It
-extracts code samples from documentation comments and executes them. See the
-[rustdoc book](https://doc.rust-lang.org/rustdoc/) for more information on
-writing doc tests.
+extracts code samples from documentation comments of the library target, and
+then executes them. See the [rustdoc book](https://doc.rust-lang.org/rustdoc/)
+for more information on writing doc tests.
 
 ## OPTIONS
 

diff --git a/src/doc/man/generated_txt/cargo-test.txt b/src/doc/man/generated_txt/cargo-test.txt
index 56e3641b1d64ac3b9e5dabc619e6a77d3f1c974e..c2606bbb8780035f6e727248f73060a5c8e190cc 100644 (file)
--- a/src/doc/man/generated_txt/cargo-test.txt
+++ b/src/doc/man/generated_txt/cargo-test.txt
@@ -34,9 +34,10 @@ DESCRIPTION
        its own main function to handle running tests.
 
        Documentation tests are also run by default, which is handled by
-       rustdoc. It extracts code samples from documentation comments and
-       executes them. See the rustdoc book <https://doc.rust-lang.org/rustdoc/>
-       for more information on writing doc tests.
+       rustdoc. It extracts code samples from documentation comments of the
+       library target, and then executes them. See the rustdoc book
+       <https://doc.rust-lang.org/rustdoc/> for more information on writing doc
+       tests.
 
 OPTIONS
    Test Options

diff --git a/src/doc/src/commands/cargo-test.md b/src/doc/src/commands/cargo-test.md
index 203fee22979e9e7760fd769a265ba7d8b00af879..cad1675d6621e3e9902c332470ccc93edca13087 100644 (file)
--- a/src/doc/src/commands/cargo-test.md
+++ b/src/doc/src/commands/cargo-test.md
@@ -38,9 +38,9 @@ manifest settings, in which case your code will need to provide its own `main`
 function to handle running tests.
 
 Documentation tests are also run by default, which is handled by `rustdoc`. It
-extracts code samples from documentation comments and executes them. See the
-[rustdoc book](https://doc.rust-lang.org/rustdoc/) for more information on
-writing doc tests.
+extracts code samples from documentation comments of the library target, and
+then executes them. See the [rustdoc book](https://doc.rust-lang.org/rustdoc/)
+for more information on writing doc tests.
 
 ## OPTIONS
 

diff --git a/src/etc/man/cargo-test.1 b/src/etc/man/cargo-test.1
index a1e32a405c40de6a4d8abaaf4e9a98d5e51a6784..6c5180194045a5d2d088f7645397af724ecdf633 100644 (file)
--- a/src/etc/man/cargo-test.1
+++ b/src/etc/man/cargo-test.1
@@ -38,9 +38,9 @@ manifest settings, in which case your code will need to provide its own \fBmain\
 function to handle running tests.
 .sp
 Documentation tests are also run by default, which is handled by \fBrustdoc\fR\&. It
-extracts code samples from documentation comments and executes them. See the
-\fIrustdoc book\fR <https://doc.rust\-lang.org/rustdoc/> for more information on
-writing doc tests.
+extracts code samples from documentation comments of the library target, and
+then executes them. See the \fIrustdoc book\fR <https://doc.rust\-lang.org/rustdoc/>
+for more information on writing doc tests.
 .SH "OPTIONS"
 .SS "Test Options"
 .sp