diff --git a/src/doc/man/cargo-package.md b/src/doc/man/cargo-package.md
index 05d0925971f2..8888f11f282d 100644
--- a/src/doc/man/cargo-package.md
+++ b/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:
 
diff --git a/src/doc/man/generated_txt/cargo-package.txt b/src/doc/man/generated_txt/cargo-package.txt
index 1cbee4807096..c8002f0b8888 100644
--- a/src/doc/man/generated_txt/cargo-package.txt
+++ b/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.
diff --git a/src/doc/src/commands/cargo-package.md b/src/doc/src/commands/cargo-package.md
index 87f56f98809d..2707a4ee5d74 100644
--- a/src/doc/src/commands/cargo-package.md
+++ b/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:
 
diff --git a/src/etc/man/cargo-package.1 b/src/etc/man/cargo-package.1
index f515beaad5a5..da8dfd5d109a 100644
--- a/src/etc/man/cargo-package.1
+++ b/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