Skip to content

Commit 0bf619b

Browse files
committed
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.
1 parent 01e3b54 commit 0bf619b

6 files changed

Lines changed: 69 additions & 0 deletions

File tree

completions/bash/brew

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -407,6 +407,22 @@ off)
407407
esac
408408
}
409409

410+
_brew_as_console_user() {
411+
local cur="${COMP_WORDS[COMP_CWORD]}"
412+
case "${cur}" in
413+
-*)
414+
__brewcomp "
415+
--debug
416+
--help
417+
--quiet
418+
--verbose
419+
"
420+
return
421+
;;
422+
*) ;;
423+
esac
424+
}
425+
410426
_brew_audit() {
411427
local cur="${COMP_WORDS[COMP_CWORD]}"
412428
case "${cur}" in
@@ -2061,6 +2077,7 @@ _brew_outdated() {
20612077
--greedy-latest
20622078
--help
20632079
--json
2080+
--minimum-version
20642081
--quiet
20652082
--verbose
20662083
"
@@ -3269,6 +3286,7 @@ _brew_upgrade() {
32693286
--keyboard-layoutdir
32703287
--language
32713288
--mdimporterdir
3289+
--minimum-version
32723290
--no-binaries
32733291
--overwrite
32743292
--prefpanedir
@@ -3457,6 +3475,7 @@ _brew() {
34573475
--version) _brew___version ;;
34583476
alias) _brew_alias ;;
34593477
analytics) _brew_analytics ;;
3478+
as-console-user) _brew_as_console_user ;;
34603479
audit) _brew_audit ;;
34613480
autoremove) _brew_autoremove ;;
34623481
bottle) _brew_bottle ;;

completions/fish/brew.fish

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -348,6 +348,13 @@ __fish_brew_complete_sub_arg 'analytics' 'off' -l quiet -d 'Make some output mor
348348
__fish_brew_complete_sub_arg 'analytics' 'off' -l verbose -d 'Make some output more verbose'
349349

350350

351+
__fish_brew_complete_cmd 'as-console-user' 'Run a Homebrew command as the active macOS console user'
352+
__fish_brew_complete_arg 'as-console-user' -l debug -d 'Display any debugging information'
353+
__fish_brew_complete_arg 'as-console-user' -l help -d 'Show this message'
354+
__fish_brew_complete_arg 'as-console-user' -l quiet -d 'Make some output more quiet'
355+
__fish_brew_complete_arg 'as-console-user' -l verbose -d 'Make some output more verbose'
356+
357+
351358
__fish_brew_complete_cmd 'audit' 'Check formula or cask for Homebrew coding style violations'
352359
__fish_brew_complete_arg 'audit' -l arch -d 'Audit the given CPU architecture. (Pass `all` to audit all architectures.)'
353360
__fish_brew_complete_arg 'audit' -l audit-debug -d 'Enable debugging and profiling of audit methods'
@@ -1339,6 +1346,7 @@ __fish_brew_complete_arg 'outdated' -l greedy-auto-updates -d 'Also include outd
13391346
__fish_brew_complete_arg 'outdated' -l greedy-latest -d 'Also include outdated casks including those with `version :latest`'
13401347
__fish_brew_complete_arg 'outdated' -l help -d 'Show this message'
13411348
__fish_brew_complete_arg 'outdated' -l json -d 'Print output in JSON format. There are two versions: `v1` and `v2`. `v1` is deprecated and is currently the default if no version is specified. `v2` prints outdated formulae and casks'
1349+
__fish_brew_complete_arg 'outdated' -l minimum-version -d 'Only list a named formula or cask with an installed version below the given minimum version'
13421350
__fish_brew_complete_arg 'outdated' -l quiet -d 'List only the names of outdated kegs (takes precedence over `--verbose`)'
13431351
__fish_brew_complete_arg 'outdated' -l verbose -d 'Include detailed version information'
13441352
__fish_brew_complete_arg 'outdated; and not __fish_seen_argument -l cask -l casks' -a '(__fish_brew_suggest_formulae_all)'
@@ -2059,6 +2067,7 @@ __fish_brew_complete_arg 'upgrade' -l keep-tmp -d 'Retain the temporary files cr
20592067
__fish_brew_complete_arg 'upgrade' -l keyboard-layoutdir -d 'Target location for Keyboard Layouts (default: `/Library/Keyboard Layouts`)'
20602068
__fish_brew_complete_arg 'upgrade' -l language -d 'Comma-separated list of language codes to prefer for cask installation. The first matching language is used, otherwise it reverts to the cask\'s default language. The default value is the language of your system'
20612069
__fish_brew_complete_arg 'upgrade' -l mdimporterdir -d 'Target location for Spotlight Plugins (default: `~/Library/Spotlight`)'
2070+
__fish_brew_complete_arg 'upgrade' -l minimum-version -d 'Only upgrade a named formula or cask with an installed version below the given minimum version'
20622071
__fish_brew_complete_arg 'upgrade' -l no-binaries -d 'Disable/enable linking of helper executables (default: enabled)'
20632072
__fish_brew_complete_arg 'upgrade' -l overwrite -d 'Delete files that already exist in the prefix while linking'
20642073
__fish_brew_complete_arg 'upgrade' -l prefpanedir -d 'Target location for Preference Panes (default: `~/Library/PreferencePanes`)'

completions/internal_commands_list.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
--version
99
alias
1010
analytics
11+
as-console-user
1112
audit
1213
autoremove
1314
bottle

completions/zsh/_brew

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,7 @@ __brew_internal_commands() {
143143
'--version:Print the version numbers of Homebrew, Homebrew/homebrew-core and Homebrew/homebrew-cask (if tapped) to standard output'
144144
'alias:Show an alias'\''s command'
145145
'analytics:Control Homebrew'\''s anonymous aggregate user behaviour analytics'
146+
'as-console-user:Run a Homebrew command as the active macOS console user'
146147
'audit:Check formula or cask for Homebrew coding style violations'
147148
'autoremove:Uninstall formulae that were only installed as a dependency of another formula and are now no longer needed'
148149
'bottle:Generate a bottle (binary package) from a formula that was installed with `--build-bottle`'
@@ -451,6 +452,15 @@ off)
451452
esac
452453
}
453454

455+
# brew as-console-user
456+
_brew_as_console_user() {
457+
_arguments \
458+
'--debug[Display any debugging information]' \
459+
'--help[Show this message]' \
460+
'--quiet[Make some output more quiet]' \
461+
'--verbose[Make some output more verbose]'
462+
}
463+
454464
# brew audit
455465
_brew_audit() {
456466
_arguments \
@@ -1713,6 +1723,7 @@ _brew_outdated() {
17131723
'--greedy-latest[Also include outdated casks including those with `version :latest`]' \
17141724
'--help[Show this message]' \
17151725
'(--quiet --verbose)--json[Print output in JSON format. There are two versions: `v1` and `v2`. `v1` is deprecated and is currently the default if no version is specified. `v2` prints outdated formulae and casks]' \
1726+
'--minimum-version[Only list a named formula or cask with an installed version below the given minimum version]' \
17161727
'(--verbose --json)--quiet[List only the names of outdated kegs (takes precedence over `--verbose`)]' \
17171728
'(--quiet --json)--verbose[Include detailed version information]' \
17181729
- formula \
@@ -2615,6 +2626,7 @@ _brew_upgrade() {
26152626
'(--formula)--keyboard-layoutdir[Target location for Keyboard Layouts (default: `/Library/Keyboard Layouts`)]' \
26162627
'(--formula)--language[Comma-separated list of language codes to prefer for cask installation. The first matching language is used, otherwise it reverts to the cask'\''s default language. The default value is the language of your system]' \
26172628
'(--formula)--mdimporterdir[Target location for Spotlight Plugins (default: `~/Library/Spotlight`)]' \
2629+
'--minimum-version[Only upgrade a named formula or cask with an installed version below the given minimum version]' \
26182630
'--no-binaries[Disable/enable linking of helper executables (default: enabled)]' \
26192631
'(--cask)--overwrite[Delete files that already exist in the prefix while linking]' \
26202632
'(--formula)--prefpanedir[Target location for Preference Panes (default: `~/Library/PreferencePanes`)]' \

docs/Manpage.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,14 @@ Control Homebrew's anonymous aggregate user behaviour analytics. Read more at
133133

134134
: Turn Homebrew's analytics off.
135135

136+
### `as-console-user` *`command`* \[*`args`* ...\]
137+
138+
Run a Homebrew command as the active macOS console user.
139+
140+
This is intended for MDM, Munki and Jamf workflows where `brew` is invoked as
141+
root but Homebrew operations should run as the logged-in console user. The
142+
nested command is always dispatched through `HOMEBREW_BREW_FILE`.
143+
136144
### `autoremove` \[`--dry-run`\]
137145

138146
Uninstall formulae that were only installed as a dependency of another formula
@@ -1516,6 +1524,11 @@ otherwise.
15161524
deprecated and is currently the default if no version is specified. `v2`
15171525
prints outdated formulae and casks.
15181526

1527+
`--minimum-version`
1528+
1529+
: Only list a named formula or cask with an installed version below the given
1530+
minimum version.
1531+
15191532
`--fetch-HEAD`
15201533

15211534
: Fetch the upstream repository to detect if the HEAD installation of the
@@ -2126,6 +2139,11 @@ for the upgraded formulae or, every 30 days, for all formulae.
21262139

21272140
: Show what would be upgraded, but do not actually upgrade anything.
21282141

2142+
`--minimum-version`
2143+
2144+
: Only upgrade a named formula or cask with an installed version below the given
2145+
minimum version.
2146+
21292147
`--ask`
21302148

21312149
: Ask for confirmation before downloading and upgrading. Print the same plan as

manpages/brew.1

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,10 @@ Turn Homebrew\[u2019]s analytics on\.
8383
.TP
8484
\fBbrew analytics off\fP
8585
Turn Homebrew\[u2019]s analytics off\.
86+
.SS "\fBas\-console\-user\fP \fIcommand\fP \fR[\fIargs\fP \.\.\.]"
87+
Run a Homebrew command as the active macOS console user\.
88+
.P
89+
This is intended for MDM, Munki and Jamf workflows where \fBbrew\fP is invoked as root but Homebrew operations should run as the logged\-in console user\. The nested command is always dispatched through \fBHOMEBREW_BREW_FILE\fP\&\.
8690
.SS "\fBautoremove\fP \fR[\fB\-\-dry\-run\fP]"
8791
Uninstall formulae that were only installed as a dependency of another formula and are now no longer needed\.
8892
.TP
@@ -973,6 +977,9 @@ List only outdated casks\.
973977
\fB\-\-json\fP
974978
Print output in JSON format\. There are two versions: \fBv1\fP and \fBv2\fP\&\. \fBv1\fP is deprecated and is currently the default if no version is specified\. \fBv2\fP prints outdated formulae and casks\.
975979
.TP
980+
\fB\-\-minimum\-version\fP
981+
Only list a named formula or cask with an installed version below the given minimum version\.
982+
.TP
976983
\fB\-\-fetch\-HEAD\fP
977984
Fetch the upstream repository to detect if the HEAD installation of the formula is outdated\. Otherwise, the repository\[u2019]s HEAD will only be checked for updates when a new stable or development version has been released\.
978985
.TP
@@ -1347,6 +1354,9 @@ Print the verification and post\-install steps\.
13471354
\fB\-n\fP, \fB\-\-dry\-run\fP
13481355
Show what would be upgraded, but do not actually upgrade anything\.
13491356
.TP
1357+
\fB\-\-minimum\-version\fP
1358+
Only upgrade a named formula or cask with an installed version below the given minimum version\.
1359+
.TP
13501360
\fB\-\-ask\fP
13511361
Ask for confirmation before downloading and upgrading\. Print the same plan as \fB\-\-dry\-run\fP, including available download sizes\. Enabled by default if \fB$HOMEBREW_ASK\fP is set\.
13521362
.TP

0 commit comments

Comments
 (0)