Document workspace packaging

src/doc/man/cargo-package.md

@@ -15,7 +15,8 @@ cargo-package --- Assemble the local package into a distributable tarball
 ## DESCRIPTION
 
 This command will create a distributable, compressed `.crate` file with the
-source code of the package in the current directory. The resulting file will
+source code of the package in the current directory. When run in a workspace,
+this command will create one `.crate` file per crate. The resulting file(s) will
 be stored in the `target/package` directory. This performs the following
 steps:
 

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

@@ -9,9 +9,10 @@ SYNOPSIS
 
 DESCRIPTION
        This command will create a distributable, compressed .crate file with
-       the source code of the package in the current directory. The resulting
-       file will be stored in the target/package directory. This performs the
-       following steps:
+       the source code of the package in the current directory. When run in a
+       workspace, this command will create one .crate file per crate. The
+       resulting file(s) will be stored in the target/package directory. This
+       performs the following steps:
 
        1. Load and check the current workspace, performing some basic checks.
           o  Path dependencies are not allowed unless they have a version key.

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

@@ -10,7 +10,8 @@ cargo-package --- Assemble the local package into a distributable tarball
 ## DESCRIPTION
 
 This command will create a distributable, compressed `.crate` file with the
-source code of the package in the current directory. The resulting file will
+source code of the package in the current directory. When run in a workspace,
+this command will create one `.crate` file per crate. The resulting file(s) will
 be stored in the `target/package` directory. This performs the following
 steps:
 

src/etc/man/cargo-package.1

@@ -9,7 +9,8 @@ cargo\-package \[em] Assemble the local package into a distributable tarball
 \fBcargo package\fR [\fIoptions\fR]
 .SH "DESCRIPTION"
 This command will create a distributable, compressed \fB\&.crate\fR file with the
-source code of the package in the current directory. The resulting file will
+source code of the package in the current directory. When run in a workspace,
+this command will create one \fB\&.crate\fR file per crate. The resulting file(s) will
 be stored in the \fBtarget/package\fR directory. This performs the following
 steps:
 .sp