From efc91b27fb5378fcbc6ed61a6a1a9ca0290138b3 Mon Sep 17 00:00:00 2001
From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com>
Date: Sat, 17 May 2025 16:19:58 +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/fish/brew.fish |  2 +-
 completions/zsh/_brew      | 18 +++++++++---------
 docs/Manpage.md            | 34 +++++++++++++++++-----------------
 manpages/brew.1            | 20 ++++++++++----------
 4 files changed, 37 insertions(+), 37 deletions(-)

diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index ff6e37aa56..e569c1be4f 100644
--- a/completions/fish/brew.fish
+++ b/completions/fish/brew.fish
@@ -1556,7 +1556,7 @@ __fish_brew_complete_arg 'services' -l file -d 'Use the service file from this l
 __fish_brew_complete_arg 'services' -l help -d 'Show this message'
 __fish_brew_complete_arg 'services' -l json -d 'Output as JSON'
 __fish_brew_complete_arg 'services' -l keep -d 'When stopped, don\'t unregister the service from launching at login (or boot)'
-__fish_brew_complete_arg 'services' -l max-wait -d 'Wait at most this many seconds for `stop` to finish stopping a service. Omit this flag or set this to zero (0) seconds to wait indefinitely'
+__fish_brew_complete_arg 'services' -l max-wait -d 'Wait at most this many seconds for `stop` to finish stopping a service. Defaults to 60. Set this to zero (0) seconds to wait indefinitely'
 __fish_brew_complete_arg 'services' -l no-wait -d 'Don\'t wait for `stop` to finish stopping the service'
 __fish_brew_complete_arg 'services' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'services' -l sudo-service-user -d 'When run as root on macOS, run the service(s) as this user'
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index 72453df3d6..bdba3d7058 100644
--- a/completions/zsh/_brew
+++ b/completions/zsh/_brew
@@ -1195,7 +1195,7 @@ _brew_instal() {
     '(--formula --force)--adopt[Adopt existing artifacts in the destination that are identical to those being installed. Cannot be combined with `--force`]' \
     '(--formula)--appdir[Target location for Applications (default: `/Applications`)]' \
     '(--cask)--as-dependency[Install but mark as installed as a dependency and not installed on request]' \
-    '(--cask)--ask[Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size]' \
+    '--ask[Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size]' \
     '(--formula)--audio-unit-plugindir[Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)]' \
     '(--formula)--binaries[Disable/enable linking of helper executables (default: enabled)]' \
     '(--cask)--bottle-arch[Optimise bottles for the specified architecture rather than the oldest architecture supported by the version of macOS the bottles are built on]' \
@@ -1245,7 +1245,7 @@ _brew_instal() {
     '(--casks --binaries --require-sha --quarantine --adopt --skip-cask-deps --zap --appdir --keyboard-layoutdir --colorpickerdir --prefpanedir --qlplugindir --mdimporterdir --dictionarydir --fontdir --servicedir --input-methoddir --internet-plugindir --audio-unit-plugindir --vst-plugindir --vst3-plugindir --screen-saverdir --language)--formula[Treat all named arguments as formulae]' \
     '*:formula:__brew_formulae' \
     - cask \
-    '(--formulae --env --ignore-dependencies --only-dependencies --cc --build-from-source --force-bottle --include-test --HEAD --fetch-HEAD --keep-tmp --debug-symbols --build-bottle --skip-post-install --skip-link --as-dependency --bottle-arch --interactive --git --overwrite --ask)--cask[Treat all named arguments as casks]' \
+    '(--formulae --env --ignore-dependencies --only-dependencies --cc --build-from-source --force-bottle --include-test --HEAD --fetch-HEAD --keep-tmp --debug-symbols --build-bottle --skip-post-install --skip-link --as-dependency --bottle-arch --interactive --git --overwrite)--cask[Treat all named arguments as casks]' \
     '*:cask:__brew_casks'
 }
 
@@ -1256,7 +1256,7 @@ _brew_install() {
     '(--formula --force)--adopt[Adopt existing artifacts in the destination that are identical to those being installed. Cannot be combined with `--force`]' \
     '(--formula)--appdir[Target location for Applications (default: `/Applications`)]' \
     '(--cask)--as-dependency[Install but mark as installed as a dependency and not installed on request]' \
-    '(--cask)--ask[Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size]' \
+    '--ask[Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size]' \
     '(--formula)--audio-unit-plugindir[Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)]' \
     '(--formula)--binaries[Disable/enable linking of helper executables (default: enabled)]' \
     '(--cask)--bottle-arch[Optimise bottles for the specified architecture rather than the oldest architecture supported by the version of macOS the bottles are built on]' \
@@ -1306,7 +1306,7 @@ _brew_install() {
     '(--casks --binaries --require-sha --quarantine --adopt --skip-cask-deps --zap --appdir --keyboard-layoutdir --colorpickerdir --prefpanedir --qlplugindir --mdimporterdir --dictionarydir --fontdir --servicedir --input-methoddir --internet-plugindir --audio-unit-plugindir --vst-plugindir --vst3-plugindir --screen-saverdir --language)--formula[Treat all named arguments as formulae]' \
     '*:formula:__brew_formulae' \
     - cask \
-    '(--formulae --env --ignore-dependencies --only-dependencies --cc --build-from-source --force-bottle --include-test --HEAD --fetch-HEAD --keep-tmp --debug-symbols --build-bottle --skip-post-install --skip-link --as-dependency --bottle-arch --interactive --git --overwrite --ask)--cask[Treat all named arguments as casks]' \
+    '(--formulae --env --ignore-dependencies --only-dependencies --cc --build-from-source --force-bottle --include-test --HEAD --fetch-HEAD --keep-tmp --debug-symbols --build-bottle --skip-post-install --skip-link --as-dependency --bottle-arch --interactive --git --overwrite)--cask[Treat all named arguments as casks]' \
     '*:cask:__brew_casks'
 }
 
@@ -1746,7 +1746,7 @@ _brew_reinstall() {
   _arguments \
     '(--formula)--adopt[Adopt existing artifacts in the destination that are identical to those being installed. Cannot be combined with `--force`]' \
     '(--formula)--appdir[Target location for Applications (default: `/Applications`)]' \
-    '(--cask)--ask[Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size]' \
+    '--ask[Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size]' \
     '(--formula)--audio-unit-plugindir[Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)]' \
     '(--formula)--binaries[Disable/enable linking of helper executables (default: enabled)]' \
     '(--cask --force-bottle)--build-from-source[Compile formula from source even if a bottle is available]' \
@@ -1785,7 +1785,7 @@ _brew_reinstall() {
     '(--casks --binaries --require-sha --quarantine --adopt --skip-cask-deps --zap --appdir --keyboard-layoutdir --colorpickerdir --prefpanedir --qlplugindir --mdimporterdir --dictionarydir --fontdir --servicedir --input-methoddir --internet-plugindir --audio-unit-plugindir --vst-plugindir --vst3-plugindir --screen-saverdir --language)--formula[Treat all named arguments as formulae]' \
     '*:formula:__brew_formulae' \
     - cask \
-    '(--formulae --build-from-source --interactive --force-bottle --keep-tmp --debug-symbols --git --ask)--cask[Treat all named arguments as casks]' \
+    '(--formulae --build-from-source --interactive --force-bottle --keep-tmp --debug-symbols --git)--cask[Treat all named arguments as casks]' \
     '*:cask:__brew_casks'
 }
 
@@ -1902,7 +1902,7 @@ _brew_services() {
     '--help[Show this message]' \
     '--json[Output as JSON]' \
     '--keep[When stopped, don'\''t unregister the service from launching at login (or boot)]' \
-    '(--no-wait)--max-wait[Wait at most this many seconds for `stop` to finish stopping a service. Omit this flag or set this to zero (0) seconds to wait indefinitely]' \
+    '(--no-wait)--max-wait[Wait at most this many seconds for `stop` to finish stopping a service. Defaults to 60. Set this to zero (0) seconds to wait indefinitely]' \
     '(--max-wait)--no-wait[Don'\''t wait for `stop` to finish stopping the service]' \
     '--quiet[Make some output more quiet]' \
     '--sudo-service-user[When run as root on macOS, run the service(s) as this user]' \
@@ -2325,7 +2325,7 @@ _brew_update_test() {
 _brew_upgrade() {
   _arguments \
     '(--formula)--appdir[Target location for Applications (default: `/Applications`)]' \
-    '(--cask)--ask[Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size]' \
+    '--ask[Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size]' \
     '(--formula)--audio-unit-plugindir[Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)]' \
     '(--formula)--binaries[Disable/enable linking of helper executables (default: enabled)]' \
     '(--cask --force-bottle)--build-from-source[Compile formula from source even if a bottle is available]' \
@@ -2368,7 +2368,7 @@ _brew_upgrade() {
     '(--casks --skip-cask-deps --greedy --greedy-latest --greedy-auto-updates --binaries --require-sha --quarantine --appdir --keyboard-layoutdir --colorpickerdir --prefpanedir --qlplugindir --mdimporterdir --dictionarydir --fontdir --servicedir --input-methoddir --internet-plugindir --audio-unit-plugindir --vst-plugindir --vst3-plugindir --screen-saverdir --language)--formula[Treat all named arguments as formulae. If no named arguments are specified, upgrade only outdated formulae]' \
     '*:installed_formula:__brew_installed_formulae' \
     - installed_cask \
-    '(--formulae --build-from-source --interactive --force-bottle --fetch-HEAD --keep-tmp --debug-symbols --overwrite --ask)--cask[Treat all named arguments as casks. If no named arguments are specified, upgrade only outdated casks]' \
+    '(--formulae --build-from-source --interactive --force-bottle --fetch-HEAD --keep-tmp --debug-symbols --overwrite)--cask[Treat all named arguments as casks. If no named arguments are specified, upgrade only outdated casks]' \
     '*:installed_cask:__brew_installed_casks'
 }
 
diff --git a/docs/Manpage.md b/docs/Manpage.md
index e3d40b24e7..bce11be419 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -779,6 +779,11 @@ upgrade *`formula`* if it is already installed but outdated.
 
 : Show what would be installed, but do not actually install anything.
 
+`--ask`
+
+: Ask for confirmation before downloading and installing formulae. Print bottles
+  and dependencies download size and install size.
+
 `--formula`
 
 : Treat all named arguments as formulae.
@@ -873,11 +878,6 @@ upgrade *`formula`* if it is already installed but outdated.
 
 : Delete files that already exist in the prefix while linking.
 
-`--ask`
-
-: Ask for confirmation before downloading and installing formulae. Print bottles
-  and dependencies download size and install size.
-
 `--cask`
 
 : Treat all named arguments as casks.
@@ -1245,6 +1245,11 @@ for the reinstalled formulae or, every 30 days, for all formulae.
 
 : Print the verification and post-install steps.
 
+`--ask`
+
+: Ask for confirmation before downloading and upgrading formulae. Print bottles
+  and dependencies download size, install and net install size.
+
 `--formula`
 
 : Treat all named arguments as formulae.
@@ -1276,11 +1281,6 @@ for the reinstalled formulae or, every 30 days, for all formulae.
 
 : Create a Git repository, useful for creating patches to the software.
 
-`--ask`
-
-: Ask for confirmation before downloading and upgrading formulae. Print bottles
-  and dependencies download size, install and net install size.
-
 `--cask`
 
 : Treat all named arguments as casks.
@@ -1435,8 +1435,8 @@ If `sudo` is passed, operate on `/Library/LaunchDaemons` or
 
 `--max-wait`
 
-: Wait at most this many seconds for `stop` to finish stopping a service. Omit
-  this flag or set this to zero (0) seconds to wait indefinitely.
+: Wait at most this many seconds for `stop` to finish stopping a service.
+  Defaults to 60. Set this to zero (0) seconds to wait indefinitely.
 
 `--all`
 
@@ -1679,6 +1679,11 @@ for the upgraded formulae or, every 30 days, for all formulae.
 
 : Show what would be upgraded, but do not actually upgrade anything.
 
+`--ask`
+
+: Ask for confirmation before downloading and upgrading formulae. Print bottles
+  and dependencies download size, install and net install size.
+
 `--formula`
 
 : Treat all named arguments as formulae. If no named arguments are specified,
@@ -1717,11 +1722,6 @@ for the upgraded formulae or, every 30 days, for all formulae.
 
 : Delete files that already exist in the prefix while linking.
 
-`--ask`
-
-: Ask for confirmation before downloading and upgrading formulae. Print bottles
-  and dependencies download size, install and net install size.
-
 `--cask`
 
 : Treat all named arguments as casks. If no named arguments are specified,
diff --git a/manpages/brew.1 b/manpages/brew.1
index db1cb6c5a6..70c81844ec 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -487,6 +487,9 @@ Print the verification and post\-install steps\.
 \fB\-n\fP, \fB\-\-dry\-run\fP
 Show what would be installed, but do not actually install anything\.
 .TP
+\fB\-\-ask\fP
+Ask for confirmation before downloading and installing formulae\. Print bottles and dependencies download size and install size\.
+.TP
 \fB\-\-formula\fP
 Treat all named arguments as formulae\.
 .TP
@@ -544,9 +547,6 @@ Create a Git repository, useful for creating patches to the software\.
 \fB\-\-overwrite\fP
 Delete files that already exist in the prefix while linking\.
 .TP
-\fB\-\-ask\fP
-Ask for confirmation before downloading and installing formulae\. Print bottles and dependencies download size and install size\.
-.TP
 \fB\-\-cask\fP
 Treat all named arguments as casks\.
 .TP
@@ -775,6 +775,9 @@ Install without checking for previously installed keg\-only or non\-migrated ver
 \fB\-v\fP, \fB\-\-verbose\fP
 Print the verification and post\-install steps\.
 .TP
+\fB\-\-ask\fP
+Ask for confirmation before downloading and upgrading formulae\. Print bottles and dependencies download size, install and net install size\.
+.TP
 \fB\-\-formula\fP
 Treat all named arguments as formulae\.
 .TP
@@ -796,9 +799,6 @@ Generate debug symbols on build\. Source will be retained in a cache directory\.
 \fB\-g\fP, \fB\-\-git\fP
 Create a Git repository, useful for creating patches to the software\.
 .TP
-\fB\-\-ask\fP
-Ask for confirmation before downloading and upgrading formulae\. Print bottles and dependencies download size, install and net install size\.
-.TP
 \fB\-\-cask\fP
 Treat all named arguments as casks\.
 .TP
@@ -902,7 +902,7 @@ Use the service file from this location to \fBstart\fP the service\.
 When run as root on macOS, run the service(s) as this user\.
 .TP
 \fB\-\-max\-wait\fP
-Wait at most this many seconds for \fBstop\fP to finish stopping a service\. Omit this flag or set this to zero (0) seconds to wait indefinitely\.
+Wait at most this many seconds for \fBstop\fP to finish stopping a service\. Defaults to 60\. Set this to zero (0) seconds to wait indefinitely\.
 .TP
 \fB\-\-all\fP
 Run \fIsubcommand\fP on all services\.
@@ -1045,6 +1045,9 @@ Print the verification and post\-install steps\.
 \fB\-n\fP, \fB\-\-dry\-run\fP
 Show what would be upgraded, but do not actually upgrade anything\.
 .TP
+\fB\-\-ask\fP
+Ask for confirmation before downloading and upgrading formulae\. Print bottles and dependencies download size, install and net install size\.
+.TP
 \fB\-\-formula\fP
 Treat all named arguments as formulae\. If no named arguments are specified, upgrade only outdated formulae\.
 .TP
@@ -1069,9 +1072,6 @@ Generate debug symbols on build\. Source will be retained in a cache directory\.
 \fB\-\-overwrite\fP
 Delete files that already exist in the prefix while linking\.
 .TP
-\fB\-\-ask\fP
-Ask for confirmation before downloading and upgrading formulae\. Print bottles and dependencies download size, install and net install size\.
-.TP
 \fB\-\-cask\fP
 Treat all named arguments as casks\. If no named arguments are specified, upgrade only outdated casks\.
 .TP