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

Update manpage and completions.

Author: bevanjkay

completions/bash/brew

@@ -2738,9 +2738,11 @@ _brew_unpack() {
   case "${cur}" in
     -*)
       __brewcomp "
+      --cask
       --debug
       --destdir
       --force
+      --formula
       --git
       --help
       --patch
@@ -2752,6 +2754,7 @@ _brew_unpack() {
     *) ;;
   esac
   __brew_complete_formulae
+  __brew_complete_casks
 }
 
 _brew_unpin() {

completions/fish/brew.fish

@@ -1778,16 +1778,19 @@ __fish_brew_complete_arg 'unlink' -l verbose -d 'Make some output more verbose'
 __fish_brew_complete_arg 'unlink' -a '(__fish_brew_suggest_formulae_installed)'
 
 
-__fish_brew_complete_cmd 'unpack' 'Unpack the source files for formula into subdirectories of the current working directory'
+__fish_brew_complete_cmd 'unpack' 'Unpack the files for the formula or cask into subdirectories of the current working directory'
+__fish_brew_complete_arg 'unpack' -l cask -d 'Treat all named arguments as casks'
 __fish_brew_complete_arg 'unpack' -l debug -d 'Display any debugging information'
 __fish_brew_complete_arg 'unpack' -l destdir -d 'Create subdirectories in the directory named by path instead'
 __fish_brew_complete_arg 'unpack' -l force -d 'Overwrite the destination directory if it already exists'
+__fish_brew_complete_arg 'unpack' -l formula -d 'Treat all named arguments as formulae'
 __fish_brew_complete_arg 'unpack' -l git -d 'Initialise a Git repository in the unpacked source. This is useful for creating patches for the software'
 __fish_brew_complete_arg 'unpack' -l help -d 'Show this message'
 __fish_brew_complete_arg 'unpack' -l patch -d 'Patches for formula will be applied to the unpacked source'
 __fish_brew_complete_arg 'unpack' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'unpack' -l verbose -d 'Make some output more verbose'
-__fish_brew_complete_arg 'unpack' -a '(__fish_brew_suggest_formulae_all)'
+__fish_brew_complete_arg 'unpack; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_all)'
+__fish_brew_complete_arg 'unpack; and not __fish_seen_argument -l formula -l formulae' -a '(__fish_brew_suggest_casks_all)'
 
 
 __fish_brew_complete_cmd 'unpin' 'Unpin formula, allowing them to be upgraded by `brew upgrade` formula'

completions/zsh/_brew

@@ -229,7 +229,7 @@ __brew_internal_commands() {
     'unbottled:Show the unbottled dependents of formulae'
     'uninstall:Uninstall a formula or cask'
     'unlink:Remove symlinks for formula from Homebrew'\''s prefix'
-    'unpack:Unpack the source files for formula into subdirectories of the current working directory'
+    'unpack:Unpack the files for the formula or cask into subdirectories of the current working directory'
     'unpin:Unpin formula, allowing them to be upgraded by `brew upgrade` formula'
     'untap:Remove a tapped formula repository'
     'update:Fetch the newest version of Homebrew and all formulae from GitHub using `git`(1) and perform any necessary migrations'
@@ -2193,13 +2193,17 @@ _brew_unpack() {
     '--debug[Display any debugging information]' \
     '--destdir[Create subdirectories in the directory named by path instead]' \
     '--force[Overwrite the destination directory if it already exists]' \
-    '(--patch)--git[Initialise a Git repository in the unpacked source. This is useful for creating patches for the software]' \
+    '(--patch --cask)--git[Initialise a Git repository in the unpacked source. This is useful for creating patches for the software]' \
     '--help[Show this message]' \
-    '(--git)--patch[Patches for formula will be applied to the unpacked source]' \
+    '(--git --cask)--patch[Patches for formula will be applied to the unpacked source]' \
     '--quiet[Make some output more quiet]' \
     '--verbose[Make some output more verbose]' \
     - formula \
-    '*:formula:__brew_formulae'
+    '(--cask)--formula[Treat all named arguments as formulae]' \
+    '*:formula:__brew_formulae' \
+    - cask \
+    '(--formula --patch --git)--cask[Treat all named arguments as casks]' \
+    '*:cask:__brew_casks'
 }
 
 # brew unpin

docs/Manpage.md

@@ -3304,10 +3304,10 @@ Show the unbottled dependents of formulae.
 : Evaluate all available formulae and casks, whether installed or not, to check
   them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
 
-### `unpack` \[*`options`*\] *`formula`* \[...\]
+### `unpack` \[*`options`*\] *`formula`*\|*`cask`* \[...\]
 
-Unpack the source files for *`formula`* into subdirectories of the current
-working directory.
+Unpack the files for the *`formula`* or *`cask`* into subdirectories of the
+current working directory.
 
 `--destdir`
 
@@ -3326,6 +3326,14 @@ working directory.
 
 : Overwrite the destination directory if it already exists.
 
+`--formula`
+
+: Treat all named arguments as formulae.
+
+`--cask`
+
+: Treat all named arguments as casks.
+
 ### `update-license-data`
 
 Update SPDX license data in the Homebrew repository.
@@ -3755,7 +3763,7 @@ and Linux workers.
 
 : Use these tested formulae from formulae steps for a formulae dependents step.
 
-### `which-formula` \[`--explain`\] *`command`* \[...\]
+### `which-formula` \[`--explain`\] \[`--skip-update`\] *`command`* \[...\]
 
 Show which formula(e) provides the given command.
 
@@ -3764,6 +3772,11 @@ Show which formula(e) provides the given command.
 : Output explanation of how to get *`command`* by installing one of the
   providing formulae.
 
+`--skip-update`
+
+: Skip updating the executables database if any version exists on disk, no
+  matter how old.
+
 ### `which-update` \[*`options`*\] \[*`database`*\]
 
 Database update for `brew which-formula`.

manpages/brew.1

@@ -1,5 +1,5 @@
 .\" generated by kramdown
-.TH "BREW" "1" "August 2025" "Homebrew"
+.TH "BREW" "1" "September 2025" "Homebrew"
 .SH NAME
 brew \- The Missing Package Manager for macOS (or Linux)
 .SH "SYNOPSIS"
@@ -2102,8 +2102,8 @@ Print the \fBhomebrew/core\fP commits where bottles were lost in the last week\.
 .TP
 \fB\-\-eval\-all\fP
 Evaluate all available formulae and casks, whether installed or not, to check them\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
-.SS "\fBunpack\fP \fR[\fIoptions\fP] \fIformula\fP \fR[\.\.\.]"
-Unpack the source files for \fIformula\fP into subdirectories of the current working directory\.
+.SS "\fBunpack\fP \fR[\fIoptions\fP] \fIformula\fP|\fIcask\fP \fR[\.\.\.]"
+Unpack the files for the \fIformula\fP or \fIcask\fP into subdirectories of the current working directory\.
 .TP
 \fB\-\-destdir\fP
 Create subdirectories in the directory named by \fIpath\fP instead\.
@@ -2116,6 +2116,12 @@ Initialise a Git repository in the unpacked source\. This is useful for creating
 .TP
 \fB\-f\fP, \fB\-\-force\fP
 Overwrite the destination directory if it already exists\.
+.TP
+\fB\-\-formula\fP
+Treat all named arguments as formulae\.
+.TP
+\fB\-\-cask\fP
+Treat all named arguments as casks\.
 .SS "\fBupdate\-license\-data\fP"
 Update SPDX license data in the Homebrew repository\.
 .SS "\fBupdate\-maintainers\fP"
@@ -2403,11 +2409,14 @@ Use these skipped or failed formulae from formulae steps for a formulae dependen
 .TP
 \fB\-\-tested\-formulae\fP
 Use these tested formulae from formulae steps for a formulae dependents step\.
-.SS "\fBwhich\-formula\fP \fR[\fB\-\-explain\fP] \fIcommand\fP \fR[\.\.\.]"
+.SS "\fBwhich\-formula\fP \fR[\fB\-\-explain\fP] \fR[\fB\-\-skip\-update\fP] \fIcommand\fP \fR[\.\.\.]"
 Show which formula(e) provides the given command\.
 .TP
 \fB\-\-explain\fP
 Output explanation of how to get \fIcommand\fP by installing one of the providing formulae\.
+.TP
+\fB\-\-skip\-update\fP
+Skip updating the executables database if any version exists on disk, no matter how old\.
 .SS "\fBwhich\-update\fP \fR[\fIoptions\fP] \fR[\fIdatabase\fP]"
 Database update for \fBbrew which\-formula\fP\&\.
 .TP