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

Update manpage and completions.

Author: p-linnane

completions/fish/brew.fish

@@ -1112,7 +1112,7 @@ __fish_brew_complete_arg 'install' -l adopt -d 'Adopt existing artifacts in the
 __fish_brew_complete_arg 'install' -l appdir -d 'Target location for Applications (default: `/Applications`)'
 __fish_brew_complete_arg 'install' -l appimagedir -d 'Target location for AppImages (default: `~/Applications`)'
 __fish_brew_complete_arg 'install' -l as-dependency -d 'Install but mark as installed as a dependency and not installed on request'
-__fish_brew_complete_arg 'install' -l ask -d 'Ask for confirmation before downloading and installing. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles. Enabled by default if `$HOMEBREW_ASK` is set'
+__fish_brew_complete_arg 'install' -l ask -d 'Ask for confirmation before downloading and installing. Print the same plan as `--dry-run` before prompting. Enabled by default if `$HOMEBREW_ASK` is set'
 __fish_brew_complete_arg 'install' -l audio-unit-plugindir -d 'Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)'
 __fish_brew_complete_arg 'install' -l binaries -d 'Disable/enable linking of helper executables (default: enabled)'
 __fish_brew_complete_arg 'install' -l bottle-arch -d 'Optimise bottles for the specified architecture rather than the oldest architecture supported by the version of macOS the bottles are built on'
@@ -1474,7 +1474,7 @@ __fish_brew_complete_cmd 'reinstall' 'Uninstall and then reinstall a formula or
 __fish_brew_complete_arg 'reinstall' -l adopt -d 'Adopt existing artifacts in the destination that are identical to those being installed. Cannot be combined with `--force`'
 __fish_brew_complete_arg 'reinstall' -l appdir -d 'Target location for Applications (default: `/Applications`)'
 __fish_brew_complete_arg 'reinstall' -l appimagedir -d 'Target location for AppImages (default: `~/Applications`)'
-__fish_brew_complete_arg 'reinstall' -l ask -d 'Ask for confirmation before downloading and reinstalling. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles. Enabled by default if `$HOMEBREW_ASK` is set'
+__fish_brew_complete_arg 'reinstall' -l ask -d 'Ask for confirmation before downloading and reinstalling. Print what would be reinstalled before prompting. Enabled by default if `$HOMEBREW_ASK` is set'
 __fish_brew_complete_arg 'reinstall' -l audio-unit-plugindir -d 'Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)'
 __fish_brew_complete_arg 'reinstall' -l binaries -d 'Disable/enable linking of helper executables (default: enabled)'
 __fish_brew_complete_arg 'reinstall' -l build-from-source -d 'Compile formula from source even if a bottle is available'

completions/zsh/_brew

@@ -1444,7 +1444,7 @@ _brew_install() {
     '(--formula)--appdir[Target location for Applications (default: `/Applications`)]' \
     '(--formula)--appimagedir[Target location for AppImages (default: `~/Applications`)]' \
     '(--cask)--as-dependency[Install but mark as installed as a dependency and not installed on request]' \
-    '--ask[Ask for confirmation before downloading and installing. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles. Enabled by default if `$HOMEBREW_ASK` is set]' \
+    '--ask[Ask for confirmation before downloading and installing. Print the same plan as `--dry-run` before prompting. Enabled by default if `$HOMEBREW_ASK` is set]' \
     '(--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]' \
@@ -1879,7 +1879,7 @@ _brew_reinstall() {
     '(--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`)]' \
     '(--formula)--appimagedir[Target location for AppImages (default: `~/Applications`)]' \
-    '--ask[Ask for confirmation before downloading and reinstalling. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles. Enabled by default if `$HOMEBREW_ASK` is set]' \
+    '--ask[Ask for confirmation before downloading and reinstalling. Print what would be reinstalled before prompting. Enabled by default if `$HOMEBREW_ASK` is set]' \
     '(--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]' \

docs/Manpage.md

@@ -1151,10 +1151,8 @@ upgrade *`formula`* if it is already installed but outdated.
 
 `--ask`
 
-: Ask for confirmation before downloading and installing. Print a dependency
-  plan, including added, changed and removed packages and dependencies, with
-  download and install sizes of formula bottles. Enabled by default if
-  `$HOMEBREW_ASK` is set.
+: Ask for confirmation before downloading and installing. Print the same plan as
+  `--dry-run` before prompting. Enabled by default if `$HOMEBREW_ASK` is set.
 
 `--formula`
 
@@ -1636,10 +1634,8 @@ for the reinstalled formulae or, every 30 days, for all formulae.
 
 `--ask`
 
-: Ask for confirmation before downloading and reinstalling. Print a dependency
-  plan, including added, changed and removed packages and dependencies, with
-  download and install sizes of formula bottles. Enabled by default if
-  `$HOMEBREW_ASK` is set.
+: Ask for confirmation before downloading and reinstalling. Print what would be
+  reinstalled before prompting. Enabled by default if `$HOMEBREW_ASK` is set.
 
 `--formula`
 

manpages/brew.1

@@ -745,7 +745,7 @@ Print the verification and post\-install steps\.
 Show what would be installed, but do not actually install anything\.
 .TP
 \fB\-\-ask\fP
-Ask for confirmation before downloading and installing\. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles\. Enabled by default if \fB$HOMEBREW_ASK\fP is set\.
+Ask for confirmation before downloading and installing\. Print the same plan as \fB\-\-dry\-run\fP before prompting\. Enabled by default if \fB$HOMEBREW_ASK\fP is set\.
 .TP
 \fB\-\-formula\fP
 Treat all named arguments as formulae\.
@@ -1041,7 +1041,7 @@ Install without checking for previously installed keg\-only or non\-migrated ver
 Print the verification and post\-install steps\.
 .TP
 \fB\-\-ask\fP
-Ask for confirmation before downloading and reinstalling\. Print a dependency plan, including added, changed and removed packages and dependencies, with download and install sizes of formula bottles\. Enabled by default if \fB$HOMEBREW_ASK\fP is set\.
+Ask for confirmation before downloading and reinstalling\. Print what would be reinstalled before prompting\. Enabled by default if \fB$HOMEBREW_ASK\fP is set\.
 .TP
 \fB\-\-formula\fP
 Treat all named arguments as formulae\.