diff --git a/src/doc/man/cargo-update.md b/src/doc/man/cargo-update.md
index b392b83145f7..efc9bee36436 100644
--- a/src/doc/man/cargo-update.md
+++ b/src/doc/man/cargo-update.md
@@ -42,6 +42,10 @@ Cannot be used with `--precise`.
When used with _spec_, allows you to specify a specific version number to set
the package to. If the package comes from a git repository, this can be a git
revision (such as a SHA hash or tag).
+
+While not recommended, specifying a yanked version of a package is allowed (nightly only).
+When possible, try other non-yanked SemVer-compatible versions, or seek helps
+from the maintainers of the package.
{{/option}}
{{#option "`-w`" "`--workspace`" }}
diff --git a/src/doc/man/generated_txt/cargo-update.txt b/src/doc/man/generated_txt/cargo-update.txt
index a96a34c962e8..226f1a5c86bf 100644
--- a/src/doc/man/generated_txt/cargo-update.txt
+++ b/src/doc/man/generated_txt/cargo-update.txt
@@ -35,6 +35,11 @@ OPTIONS
to set the package to. If the package comes from a git repository,
this can be a git revision (such as a SHA hash or tag).
+ While not recommended, specifying a yanked version of a package is
+ allowed (nightly only). When possible, try other non-yanked
+ SemVer-compatible versions, or seek helps from the maintainers of
+ the package.
+
-w, --workspace
Attempt to update only packages defined in the workspace. Other
packages are updated only if they don’t already exist in the
diff --git a/src/doc/src/commands/cargo-update.md b/src/doc/src/commands/cargo-update.md
index ef44e487bb09..8725c1c1077a 100644
--- a/src/doc/src/commands/cargo-update.md
+++ b/src/doc/src/commands/cargo-update.md
@@ -39,7 +39,10 @@ Cannot be used with --precise
.
--precise
preciseWhile not recommended, specifying a yanked version of a package is allowed (nightly only). +When possible, try other non-yanked SemVer-compatible versions, or seek helps +from the maintainers of the package.
-w