From cf654da251fff2d6487abaf6d4736161544a6772 Mon Sep 17 00:00:00 2001
From: Dawid Dziurla <dawidd0811@gmail.com>
Date: Fri, 15 Jan 2021 13:04:07 +0100
Subject: [PATCH] dev-cmd: indicate multiple named args in usage banner

---
 Library/Homebrew/dev-cmd/bottle.rb                  | 2 +-
 Library/Homebrew/dev-cmd/bump-unversioned-casks.rb  | 2 +-
 Library/Homebrew/dev-cmd/bump.rb                    | 2 +-
 Library/Homebrew/dev-cmd/command.rb                 | 2 +-
 Library/Homebrew/dev-cmd/edit.rb                    | 2 +-
 Library/Homebrew/dev-cmd/formula.rb                 | 2 +-
 Library/Homebrew/dev-cmd/irb.rb                     | 2 ++
 Library/Homebrew/dev-cmd/linkage.rb                 | 2 +-
 Library/Homebrew/dev-cmd/livecheck.rb               | 2 +-
 Library/Homebrew/dev-cmd/mirror.rb                  | 2 +-
 Library/Homebrew/dev-cmd/pr-publish.rb              | 2 +-
 Library/Homebrew/dev-cmd/pr-pull.rb                 | 2 +-
 Library/Homebrew/dev-cmd/style.rb                   | 2 +-
 Library/Homebrew/dev-cmd/test.rb                    | 2 +-
 Library/Homebrew/dev-cmd/unbottled.rb               | 2 +-
 Library/Homebrew/dev-cmd/unpack.rb                  | 2 +-
 Library/Homebrew/dev-cmd/update-python-resources.rb | 4 ++--
 17 files changed, 19 insertions(+), 17 deletions(-)

diff --git a/Library/Homebrew/dev-cmd/bottle.rb b/Library/Homebrew/dev-cmd/bottle.rb
index 02b46eb88..589808803 100644
--- a/Library/Homebrew/dev-cmd/bottle.rb
+++ b/Library/Homebrew/dev-cmd/bottle.rb
@@ -50,7 +50,7 @@ module Homebrew
   def bottle_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `bottle` [<options>] <formula>
+        `bottle` [<options>] <formula> [<formula> ...]
 
         Generate a bottle (binary package) from a formula that was installed with
         `--build-bottle`.
diff --git a/Library/Homebrew/dev-cmd/bump-unversioned-casks.rb b/Library/Homebrew/dev-cmd/bump-unversioned-casks.rb
index 83811e965..00a29fb6c 100644
--- a/Library/Homebrew/dev-cmd/bump-unversioned-casks.rb
+++ b/Library/Homebrew/dev-cmd/bump-unversioned-casks.rb
@@ -18,7 +18,7 @@ module Homebrew
   def self.bump_unversioned_casks_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `bump-unversioned-casks` [<options>] [<cask>|<tap>]
+        `bump-unversioned-casks` [<options>] <cask>|<tap> [<cask>|<tap> ...]
 
         Check all casks with unversioned URLs in a given <tap> for updates.
       EOS
diff --git a/Library/Homebrew/dev-cmd/bump.rb b/Library/Homebrew/dev-cmd/bump.rb
index 9e23cb6bd..a5bec363b 100644
--- a/Library/Homebrew/dev-cmd/bump.rb
+++ b/Library/Homebrew/dev-cmd/bump.rb
@@ -12,7 +12,7 @@ module Homebrew
   def bump_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `bump` [<options>] [<formula>]
+        `bump` [<options>] [<formula>] [<formula> ...]
 
         Display out-of-date brew formulae and the latest version available.
         Also displays whether a pull request has been opened with the URL.
diff --git a/Library/Homebrew/dev-cmd/command.rb b/Library/Homebrew/dev-cmd/command.rb
index 8b9ecc6e2..48f0384e1 100644
--- a/Library/Homebrew/dev-cmd/command.rb
+++ b/Library/Homebrew/dev-cmd/command.rb
@@ -13,7 +13,7 @@ module Homebrew
   def command_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `command` <cmd>
+        `command` <cmd> [<cmd> ...]
 
         Display the path to the file being used when invoking `brew` <cmd>.
       EOS
diff --git a/Library/Homebrew/dev-cmd/edit.rb b/Library/Homebrew/dev-cmd/edit.rb
index 83505116d..4e6a1edae 100644
--- a/Library/Homebrew/dev-cmd/edit.rb
+++ b/Library/Homebrew/dev-cmd/edit.rb
@@ -13,7 +13,7 @@ module Homebrew
   def edit_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `edit` [<formula>|<cask>]
+        `edit` [<formula>|<cask>] [<formula>|<cask> ...]
 
         Open a <formula> or <cask> in the editor set by `EDITOR` or `HOMEBREW_EDITOR`,
         or open the Homebrew repository for editing if no formula is provided.
diff --git a/Library/Homebrew/dev-cmd/formula.rb b/Library/Homebrew/dev-cmd/formula.rb
index 39f960eb4..0091f62a0 100644
--- a/Library/Homebrew/dev-cmd/formula.rb
+++ b/Library/Homebrew/dev-cmd/formula.rb
@@ -13,7 +13,7 @@ module Homebrew
   def formula_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `formula` <formula>
+        `formula` <formula> [<formula> ...]
 
         Display the path where <formula> is located.
       EOS
diff --git a/Library/Homebrew/dev-cmd/irb.rb b/Library/Homebrew/dev-cmd/irb.rb
index 2ba4d7781..6ab1a14ce 100644
--- a/Library/Homebrew/dev-cmd/irb.rb
+++ b/Library/Homebrew/dev-cmd/irb.rb
@@ -34,6 +34,8 @@ module Homebrew
       switch "--pry",
              env:         :pry,
              description: "Use Pry instead of IRB. Implied if `HOMEBREW_PRY` is set."
+
+      named_args :none
     end
   end
 
diff --git a/Library/Homebrew/dev-cmd/linkage.rb b/Library/Homebrew/dev-cmd/linkage.rb
index dcd778240..e1717c23b 100644
--- a/Library/Homebrew/dev-cmd/linkage.rb
+++ b/Library/Homebrew/dev-cmd/linkage.rb
@@ -14,7 +14,7 @@ module Homebrew
   def linkage_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `linkage` [<options>] [<formula>]
+        `linkage` [<options>] [<formula>] [<formula> ...]
 
         Check the library links from the given <formula> kegs. If no <formula> are
         provided, check all kegs. Raises an error if run on uninstalled formulae.
diff --git a/Library/Homebrew/dev-cmd/livecheck.rb b/Library/Homebrew/dev-cmd/livecheck.rb
index b27443b2c..2029b9798 100644
--- a/Library/Homebrew/dev-cmd/livecheck.rb
+++ b/Library/Homebrew/dev-cmd/livecheck.rb
@@ -20,7 +20,7 @@ module Homebrew
   def livecheck_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `livecheck` [<formulae>|<casks>]
+        `livecheck` [<formula>|<cask>] [<formula>|<cask> ...]
 
         Check for newer versions of formulae and/or casks from upstream.
 
diff --git a/Library/Homebrew/dev-cmd/mirror.rb b/Library/Homebrew/dev-cmd/mirror.rb
index 435923c0c..aa4af5a9f 100644
--- a/Library/Homebrew/dev-cmd/mirror.rb
+++ b/Library/Homebrew/dev-cmd/mirror.rb
@@ -13,7 +13,7 @@ module Homebrew
   def mirror_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `mirror` <formula>
+        `mirror` <formula> [<formula> ...]
 
         Reupload the stable URL of a formula to Bintray for use as a mirror.
       EOS
diff --git a/Library/Homebrew/dev-cmd/pr-publish.rb b/Library/Homebrew/dev-cmd/pr-publish.rb
index 7e38180d5..dc2e74727 100644
--- a/Library/Homebrew/dev-cmd/pr-publish.rb
+++ b/Library/Homebrew/dev-cmd/pr-publish.rb
@@ -29,7 +29,7 @@ module Homebrew
       flag   "--workflow=",
              description: "Target workflow filename (default: `publish-commit-bottles.yml`)."
 
-      named_args number: 1
+      named_args min: 1
     end
   end
 
diff --git a/Library/Homebrew/dev-cmd/pr-pull.rb b/Library/Homebrew/dev-cmd/pr-pull.rb
index ce569c7af..1f89438e0 100644
--- a/Library/Homebrew/dev-cmd/pr-pull.rb
+++ b/Library/Homebrew/dev-cmd/pr-pull.rb
@@ -71,7 +71,7 @@ module Homebrew
 
       conflicts "--clean", "--autosquash"
 
-      named_args number: 1
+      named_args min: 1
     end
   end
 
diff --git a/Library/Homebrew/dev-cmd/style.rb b/Library/Homebrew/dev-cmd/style.rb
index df9e5bf30..921d09d15 100644
--- a/Library/Homebrew/dev-cmd/style.rb
+++ b/Library/Homebrew/dev-cmd/style.rb
@@ -15,7 +15,7 @@ module Homebrew
   def style_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `style` [<options>] [<file>|<tap>|<formula>]
+        `style` [<options>] [<file>|<tap>|<formula>|<cask>] [<file>|<tap>|<formula>|<cask> ...]
 
         Check formulae or files for conformance to Homebrew style guidelines.
 
diff --git a/Library/Homebrew/dev-cmd/test.rb b/Library/Homebrew/dev-cmd/test.rb
index 0cd00db0f..290ebe636 100644
--- a/Library/Homebrew/dev-cmd/test.rb
+++ b/Library/Homebrew/dev-cmd/test.rb
@@ -15,7 +15,7 @@ module Homebrew
   def test_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `test` [<options>] <formula>
+        `test` [<options>] <formula> [<formula> ...]
 
         Run the test method provided by an installed formula.
         There is no standard output or return code, but generally it should notify the
diff --git a/Library/Homebrew/dev-cmd/unbottled.rb b/Library/Homebrew/dev-cmd/unbottled.rb
index 31c1d7005..2188a77d5 100644
--- a/Library/Homebrew/dev-cmd/unbottled.rb
+++ b/Library/Homebrew/dev-cmd/unbottled.rb
@@ -13,7 +13,7 @@ module Homebrew
   def unbottled_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `unbottled` [<formula>]
+        `unbottled` [<formula>] [<formula> ...]
 
         Outputs the unbottled dependents of formulae.
       EOS
diff --git a/Library/Homebrew/dev-cmd/unpack.rb b/Library/Homebrew/dev-cmd/unpack.rb
index ccce3a938..b586ad64c 100644
--- a/Library/Homebrew/dev-cmd/unpack.rb
+++ b/Library/Homebrew/dev-cmd/unpack.rb
@@ -14,7 +14,7 @@ module Homebrew
   def unpack_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `unpack` [<options>] <formula>
+        `unpack` [<options>] <formula> [<formula ...>]
 
         Unpack the source files for <formula> into subdirectories of the current
         working directory.
diff --git a/Library/Homebrew/dev-cmd/update-python-resources.rb b/Library/Homebrew/dev-cmd/update-python-resources.rb
index e9883c99a..2f7de5688 100644
--- a/Library/Homebrew/dev-cmd/update-python-resources.rb
+++ b/Library/Homebrew/dev-cmd/update-python-resources.rb
@@ -13,7 +13,7 @@ module Homebrew
   def update_python_resources_args
     Homebrew::CLI::Parser.new do
       usage_banner <<~EOS
-        `update-python-resources` [<options>] <formula>
+        `update-python-resources` [<options>] <formula> [<formula> ...]
 
         Update versions for PyPI resource blocks in <formula>.
       EOS
@@ -34,7 +34,7 @@ module Homebrew
       comma_array "--exclude-packages=",
                   description: "Exclude these packages when finding resources."
 
-      named_args :formula, number: 1
+      named_args :formula, min: 1
     end
   end