dev-cmd: indicate multiple named args in usage banner

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`.

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

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.

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

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.

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

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
 

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.

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.
 

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

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
 

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
 

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.
 

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

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

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.

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