diff --git a/Library/Homebrew/dev-cmd/pr-pull.rb b/Library/Homebrew/dev-cmd/pr-pull.rb
index 28b9547005..d35caf73fa 100644
--- a/Library/Homebrew/dev-cmd/pr-pull.rb
+++ b/Library/Homebrew/dev-cmd/pr-pull.rb
@@ -50,10 +50,8 @@ module Homebrew
              depends_on:  "--autosquash",
              description: "Message to include when autosquashing revision bumps, deletions, and rebuilds."
       flag   "--workflow=",
-             description: "Retrieve artifacts from the specified workflow (default: `tests.yml`). "\
-                          "*Legacy:* use `--workflows` instead."
-      # TODO: enable for next major/minor release
-      #      replacement: "`--workflows`"
+             description: "Retrieve artifacts from the specified workflow (default: `tests.yml`).",
+             replacement: "`--workflows`"
       flag   "--artifact=",
              description: "Download artifacts with the specified name (default: `bottles`)."
       flag   "--bintray-org=",
@@ -66,8 +64,8 @@ module Homebrew
              description: "Use the specified Bintray repository to automatically mirror stable URLs "\
                           "defined in the formulae (default: `mirror`)."
       comma_array "--workflows=",
-                  description: "Retrieve artifacts from the specified workflow (default: `tests.yml`) "\
-                               "Comma-separated list to include multiple workflows."
+                  description: "Retrieve artifacts from the specified workflow (default: `tests.yml`). "\
+                               "Can be a comma-separated list to include multiple workflows."
       comma_array "--ignore-missing-artifacts=",
                   description: "Comma-separated list of workflows which can be ignored if they have not been run."
 
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 75fe6e21d7..32956f2597 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -1150,8 +1150,6 @@ Requires write access to the repository.
   Warn instead of raising an error if the bottle upload fails. Useful for repairing bottle uploads that previously failed.
 * `--message`:
   Message to include when autosquashing revision bumps, deletions, and rebuilds.
-* `--workflow`:
-  Retrieve artifacts from the specified workflow (default: `tests.yml`). *Legacy:* use `--workflows` instead.
 * `--artifact`:
   Download artifacts with the specified name (default: `bottles`).
 * `--bintray-org`:
@@ -1163,7 +1161,7 @@ Requires write access to the repository.
 * `--bintray-mirror`:
   Use the specified Bintray repository to automatically mirror stable URLs defined in the formulae (default: `mirror`).
 * `--workflows`:
-  Retrieve artifacts from the specified workflow (default: `tests.yml`) Comma-separated list to include multiple workflows.
+  Retrieve artifacts from the specified workflow (default: `tests.yml`). Can be a comma-separated list to include multiple workflows.
 * `--ignore-missing-artifacts`:
   Comma-separated list of workflows which can be ignored if they have not been run.
 
diff --git a/manpages/brew.1 b/manpages/brew.1
index d5bc11e38f..89155b4f50 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -1604,10 +1604,6 @@ Warn instead of raising an error if the bottle upload fails\. Useful for repairi
 Message to include when autosquashing revision bumps, deletions, and rebuilds\.
 .
 .TP
-\fB\-\-workflow\fR
-Retrieve artifacts from the specified workflow (default: \fBtests\.yml\fR)\. \fILegacy:\fR use \fB\-\-workflows\fR instead\.
-.
-.TP
 \fB\-\-artifact\fR
 Download artifacts with the specified name (default: \fBbottles\fR)\.
 .
@@ -1629,7 +1625,7 @@ Use the specified Bintray repository to automatically mirror stable URLs defined
 .
 .TP
 \fB\-\-workflows\fR
-Retrieve artifacts from the specified workflow (default: \fBtests\.yml\fR) Comma\-separated list to include multiple workflows\.
+Retrieve artifacts from the specified workflow (default: \fBtests\.yml\fR)\. Can be a comma\-separated list to include multiple workflows\.
 .
 .TP
 \fB\-\-ignore\-missing\-artifacts\fR