Merge pull request #15439 from Homebrew/sponsors-maintainers-man-completions

Update manpage and completions.

completions/bash/brew

@@ -1014,6 +1014,7 @@ _brew_generate_cask_api() {
     -*)
       __brewcomp "
       --debug
+      --dry-run
       --help
       --quiet
       --verbose
@@ -1030,6 +1031,7 @@ _brew_generate_formula_api() {
     -*)
       __brewcomp "
       --debug
+      --dry-run
       --help
       --quiet
       --verbose

completions/fish/brew.fish

@@ -727,6 +727,7 @@ __fish_brew_complete_arg 'formula' -a '(__fish_brew_suggest_formulae_all)'
 
 __fish_brew_complete_cmd 'generate-cask-api' 'Generates Cask API data files for formulae.brew.sh'
 __fish_brew_complete_arg 'generate-cask-api' -l debug -d 'Display any debugging information'
+__fish_brew_complete_arg 'generate-cask-api' -l dry-run -d 'Generate API data without writing it to files'
 __fish_brew_complete_arg 'generate-cask-api' -l help -d 'Show this message'
 __fish_brew_complete_arg 'generate-cask-api' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'generate-cask-api' -l verbose -d 'Make some output more verbose'
@@ -734,6 +735,7 @@ __fish_brew_complete_arg 'generate-cask-api' -l verbose -d 'Make some output mor
 
 __fish_brew_complete_cmd 'generate-formula-api' 'Generates Formula API data files for formulae.brew.sh'
 __fish_brew_complete_arg 'generate-formula-api' -l debug -d 'Display any debugging information'
+__fish_brew_complete_arg 'generate-formula-api' -l dry-run -d 'Generate API data without writing it to files'
 __fish_brew_complete_arg 'generate-formula-api' -l help -d 'Show this message'
 __fish_brew_complete_arg 'generate-formula-api' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'generate-formula-api' -l verbose -d 'Make some output more verbose'

completions/zsh/_brew

@@ -915,6 +915,7 @@ _brew_formula() {
 _brew_generate_cask_api() {
   _arguments \
     '--debug[Display any debugging information]' \
+    '--dry-run[Generate API data without writing it to files]' \
     '--help[Show this message]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]'
@@ -924,6 +925,7 @@ _brew_generate_cask_api() {
 _brew_generate_formula_api() {
   _arguments \
     '--debug[Display any debugging information]' \
+    '--dry-run[Generate API data without writing it to files]' \
     '--help[Show this message]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]'

docs/Manpage.md

@@ -1243,18 +1243,24 @@ a formula from a tap that is not `homebrew/core` use its fully-qualified form of
 
 Display the path where *`formula`* is located.
 
-### `generate-cask-api`
+### `generate-cask-api` [`--dry-run`]
 
 Generates Cask API data files for formulae.brew.sh.
 
 The generated files are written to the current directory.
 
-### `generate-formula-api`
+* `-n`, `--dry-run`:
+  Generate API data without writing it to files.
+
+### `generate-formula-api` [`--dry-run`]
 
 Generates Formula API data files for formulae.brew.sh.
 
 The generated files are written to the current directory.
 
+* `-n`, `--dry-run`:
+  Generate API data without writing it to files.
+
 ### `generate-man-completions`
 
 Generate Homebrew's manpages and shell completions.

manpages/brew.1

@@ -1782,18 +1782,26 @@ Overwrite the destination formula if it already exists\.
 .SS "\fBformula\fR \fIformula\fR [\.\.\.]"
 Display the path where \fIformula\fR is located\.
 .
-.SS "\fBgenerate\-cask\-api\fR"
+.SS "\fBgenerate\-cask\-api\fR [\fB\-\-dry\-run\fR]"
 Generates Cask API data files for formulae\.brew\.sh\.
 .
 .P
 The generated files are written to the current directory\.
 .
-.SS "\fBgenerate\-formula\-api\fR"
+.TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Generate API data without writing it to files\.
+.
+.SS "\fBgenerate\-formula\-api\fR [\fB\-\-dry\-run\fR]"
 Generates Formula API data files for formulae\.brew\.sh\.
 .
 .P
 The generated files are written to the current directory\.
 .
+.TP
+\fB\-n\fR, \fB\-\-dry\-run\fR
+Generate API data without writing it to files\.
+.
 .SS "\fBgenerate\-man\-completions\fR"
 Generate Homebrew\'s manpages and shell completions\.
 .