From 8f2317f9084a4b9eb3ffc6c707378a717dec3f5a Mon Sep 17 00:00:00 2001 From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com> Date: Tue, 11 Mar 2025 10:09:23 +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 | 4 ++++ completions/fish/brew.fish | 4 ++++ completions/zsh/_brew | 12 ++++++++---- docs/Manpage.md | 31 +++++++++++++++++++++++++++++++ manpages/brew.1 | 18 ++++++++++++++++++ 5 files changed, 65 insertions(+), 4 deletions(-) diff --git a/completions/bash/brew b/completions/bash/brew index 704a02b4a5..0bba26ebb5 100644 --- a/completions/bash/brew +++ b/completions/bash/brew @@ -1367,6 +1367,7 @@ _brew_instal() { --HEAD --adopt --appdir + --ask --audio-unit-plugindir --binaries --bottle-arch @@ -1431,6 +1432,7 @@ _brew_install() { --HEAD --adopt --appdir + --ask --audio-unit-plugindir --binaries --bottle-arch @@ -2090,6 +2092,7 @@ _brew_reinstall() { __brewcomp " --adopt --appdir + --ask --audio-unit-plugindir --binaries --build-from-source @@ -2869,6 +2872,7 @@ _brew_upgrade() { -*) __brewcomp " --appdir + --ask --audio-unit-plugindir --binaries --build-from-source diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish index 1a00fe99aa..5dc8a97696 100644 --- a/completions/fish/brew.fish +++ b/completions/fish/brew.fish @@ -910,6 +910,7 @@ __fish_brew_complete_arg 'info; and not __fish_seen_argument -l formula -l formu __fish_brew_complete_arg 'instal' -l HEAD -d 'If formula defines it, install the HEAD version, aka. main, trunk, unstable, master' __fish_brew_complete_arg 'instal' -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 'instal' -l appdir -d 'Target location for Applications (default: `/Applications`)' +__fish_brew_complete_arg 'instal' -l ask -d 'Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size' __fish_brew_complete_arg 'instal' -l audio-unit-plugindir -d 'Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)' __fish_brew_complete_arg 'instal' -l binaries -d 'Disable/enable linking of helper executables (default: enabled)' __fish_brew_complete_arg 'instal' -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' @@ -965,6 +966,7 @@ __fish_brew_complete_cmd 'install' 'Install a formula or cask' __fish_brew_complete_arg 'install' -l HEAD -d 'If formula defines it, install the HEAD version, aka. main, trunk, unstable, master' __fish_brew_complete_arg 'install' -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 'install' -l appdir -d 'Target location for Applications (default: `/Applications`)' +__fish_brew_complete_arg 'install' -l ask -d 'Ask for confirmation before downloading and installing formulae. Print bottles and dependencies download size and install size' __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' @@ -1372,6 +1374,7 @@ __fish_brew_complete_arg 'readall' -a '(__fish_brew_suggest_taps_installed)' __fish_brew_complete_cmd 'reinstall' 'Uninstall and then reinstall a formula or cask using the same options it was originally installed with, plus any appended options specific to a formula' __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 ask -d 'Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size' __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' @@ -1813,6 +1816,7 @@ __fish_brew_complete_arg 'update-test' -l verbose -d 'Make some output more verb __fish_brew_complete_cmd 'upgrade' 'Upgrade outdated casks and outdated, unpinned formulae using the same options they were originally installed with, plus any appended brew formula options' __fish_brew_complete_arg 'upgrade' -l appdir -d 'Target location for Applications (default: `/Applications`)' +__fish_brew_complete_arg 'upgrade' -l ask -d 'Ask for confirmation before downloading and upgrading formulae. Print bottles and dependencies download size, install and net install size' __fish_brew_complete_arg 'upgrade' -l audio-unit-plugindir -d 'Target location for Audio Unit Plugins (default: `~/Library/Audio/Plug-Ins/Components`)' __fish_brew_complete_arg 'upgrade' -l binaries -d 'Disable/enable linking of helper executables (default: enabled)' __fish_brew_complete_arg 'upgrade' -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 8213c5fb53..1adde7deeb 100644 --- a/completions/zsh/_brew +++ b/completions/zsh/_brew @@ -1156,6 +1156,7 @@ _brew_instal() { '(--cask)--HEAD[If formula defines it, install the HEAD version, aka. main, trunk, unstable, master]' \ '(--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)--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]' \ @@ -1205,7 +1206,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 --bottle-arch --interactive --git --overwrite)--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 --bottle-arch --interactive --git --overwrite --ask)--cask[Treat all named arguments as casks]' \ '*::cask:__brew_casks' } @@ -1215,6 +1216,7 @@ _brew_install() { '(--cask)--HEAD[If formula defines it, install the HEAD version, aka. main, trunk, unstable, master]' \ '(--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)--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]' \ @@ -1264,7 +1266,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 --bottle-arch --interactive --git --overwrite)--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 --bottle-arch --interactive --git --overwrite --ask)--cask[Treat all named arguments as casks]' \ '*::cask:__brew_casks' } @@ -1704,6 +1706,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]' \ '(--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]' \ @@ -1742,7 +1745,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)--cask[Treat all named arguments as casks]' \ + '(--formulae --build-from-source --interactive --force-bottle --keep-tmp --debug-symbols --git --ask)--cask[Treat all named arguments as casks]' \ '*::cask:__brew_casks' } @@ -2255,6 +2258,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]' \ '(--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]' \ @@ -2297,7 +2301,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)--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 --ask)--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 862fddbb65..dcda668a4c 100644 --- a/docs/Manpage.md +++ b/docs/Manpage.md @@ -678,6 +678,11 @@ 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. @@ -1076,6 +1081,11 @@ 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. @@ -1430,6 +1440,11 @@ 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, @@ -3249,6 +3264,17 @@ By default, only Homebrew formula dependencies are listed. : Edit the `Brewfile` in your editor. +`brew bundle add` *`name`* \[...\] + +: Add entries to your `Brewfile`. Adds formulae by default. Use `--cask`, + `--tap`, `--whalebrew` or `--vscode` to add the corresponding entry instead. + +`brew bundle remove` *`name`* \[...\] + +: Remove entries that match `name` from your `Brewfile`. Use `--formula`, + `--cask`, `--tap`, `--mas`, `--whalebrew` or `--vscode` to remove only entries + of the corresponding type. + `brew bundle exec` *`command`* : Run an external command in an isolated build environment based on the @@ -3764,6 +3790,11 @@ command execution e.g. `$(cat file)`. are both set, if the request to `$HOMEBREW_ARTIFACT_DOMAIN` fails then Homebrew will error rather than trying any other/default URLs. +`HOMEBREW_ASK` + +: If set, pass `--ask`to all formulae `brew install`, `brew upgrade` and `brew + reinstall` commands. + `HOMEBREW_AUTO_UPDATE_SECS` : Run `brew update` once every `$HOMEBREW_AUTO_UPDATE_SECS` seconds before some diff --git a/manpages/brew.1 b/manpages/brew.1 index b200952860..04c72bb541 100644 --- a/manpages/brew.1 +++ b/manpages/brew.1 @@ -423,6 +423,9 @@ 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 @@ -672,6 +675,9 @@ 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 @@ -891,6 +897,9 @@ 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 @@ -2089,6 +2098,12 @@ By default, only Homebrew formula dependencies are listed\. \fBbrew bundle edit\fP Edit the \fBBrewfile\fP in your editor\. .TP +\fBbrew bundle add\fP \fIname\fP [\.\.\.] +Add entries to your \fBBrewfile\fP\&\. Adds formulae by default\. Use \fB\-\-cask\fP, \fB\-\-tap\fP, \fB\-\-whalebrew\fP or \fB\-\-vscode\fP to add the corresponding entry instead\. +.TP +\fBbrew bundle remove\fP \fIname\fP [\.\.\.] +Remove entries that match \fBname\fP from your \fBBrewfile\fP\&\. Use \fB\-\-formula\fP, \fB\-\-cask\fP, \fB\-\-tap\fP, \fB\-\-mas\fP, \fB\-\-whalebrew\fP or \fB\-\-vscode\fP to remove only entries of the corresponding type\. +.TP \fBbrew bundle exec\fP \fIcommand\fP Run an external command in an isolated build environment based on the \fBBrewfile\fP dependencies\. .P @@ -2417,6 +2432,9 @@ Prefix all download URLs, including those for bottles, with this value\. For exa \fBHOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK\fP When \fB$HOMEBREW_ARTIFACT_DOMAIN\fP and \fB$HOMEBREW_ARTIFACT_DOMAIN_NO_FALLBACK\fP are both set, if the request to \fB$HOMEBREW_ARTIFACT_DOMAIN\fP fails then Homebrew will error rather than trying any other/default URLs\. .TP +\fBHOMEBREW_ASK\fP +If set, pass \fB\-\-ask\fPto all formulae \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew reinstall\fP commands\. +.TP \fBHOMEBREW_AUTO_UPDATE_SECS\fP Run \fBbrew update\fP once every \fB$HOMEBREW_AUTO_UPDATE_SECS\fP seconds before some commands, e\.g\. \fBbrew install\fP, \fBbrew upgrade\fP and \fBbrew tap\fP\&\. Alternatively, disable auto\-update entirely with \fB$HOMEBREW_NO_AUTO_UPDATE\fP\&\. .RS