From b27548dd9706b261502560fc678bf0e2d71644b8 Mon Sep 17 00:00:00 2001
From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com>
Date: Tue, 16 May 2023 16:33:15 +0000
Subject: [PATCH] Update manpage and completions.

Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
---
 completions/bash/brew      |  2 ++
 completions/fish/brew.fish |  2 ++
 completions/zsh/_brew      |  2 ++
 docs/Manpage.md            | 10 ++++++++--
 manpages/brew.1            | 12 ++++++++++--
 5 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/completions/bash/brew b/completions/bash/brew
index e877106b28..8169c8a6fb 100644
--- a/completions/bash/brew
+++ b/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
diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index 89aa764d2b..0f2c9d101a 100644
--- a/completions/fish/brew.fish
+++ b/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'
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index 3e181dfbb6..077f6cd138 100644
--- a/completions/zsh/_brew
+++ b/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]'
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 445791bc2d..695131c061 100644
--- a/docs/Manpage.md
+++ b/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.
diff --git a/manpages/brew.1 b/manpages/brew.1
index 6bc9261cd0..6d80b2e663 100644
--- a/manpages/brew.1
+++ b/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\.
 .