diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index ea8775bb3caf7..d259f6ad245af 100644
--- a/completions/fish/brew.fish
+++ b/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'
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index dcd2bd5fb149d..a3363b3531c98 100644
--- a/completions/zsh/_brew
+++ b/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]' \
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 4591ce2eef9cc..95ce1623fe2a9 100644
--- a/docs/Manpage.md
+++ b/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`
 
diff --git a/manpages/brew.1 b/manpages/brew.1
index 4df395f5c3492..d5139a808179b 100644
--- a/manpages/brew.1
+++ b/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\.