From aa40480c4603e8faf7fd5c1edf9e2959ed5ea341 Mon Sep 17 00:00:00 2001 From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com> Date: Tue, 2 Sep 2025 08:34:29 +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 | 3 +++ completions/fish/brew.fish | 7 +++++-- completions/zsh/_brew | 12 ++++++++---- docs/Manpage.md | 21 +++++++++++++++++---- manpages/brew.1 | 17 +++++++++++++---- 5 files changed, 46 insertions(+), 14 deletions(-) diff --git a/completions/bash/brew b/completions/bash/brew index 0fa8fe64e5..d4a22fa561 100644 --- a/completions/bash/brew +++ b/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() { diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish index c242e50347..b27387dbc5 100644 --- a/completions/fish/brew.fish +++ b/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' diff --git a/completions/zsh/_brew b/completions/zsh/_brew index 01f13e60ad..ba9e1bb0d8 100644 --- a/completions/zsh/_brew +++ b/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 diff --git a/docs/Manpage.md b/docs/Manpage.md index 27e930d348..9d9fe0488c 100644 --- a/docs/Manpage.md +++ b/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`. diff --git a/manpages/brew.1 b/manpages/brew.1 index 441c787eb4..c3eeaac23a 100644 --- a/manpages/brew.1 +++ b/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