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

Update manpage and completions.

Author: MikeMcQuaid

completions/bash/brew

@@ -407,6 +407,22 @@ off)
   esac
 }
 
+_brew_as_console_user() {
+  local cur="${COMP_WORDS[COMP_CWORD]}"
+  case "${cur}" in
+    -*)
+      __brewcomp "
+      --debug
+      --help
+      --quiet
+      --verbose
+      "
+      return
+      ;;
+    *) ;;
+  esac
+}
+
 _brew_audit() {
   local cur="${COMP_WORDS[COMP_CWORD]}"
   case "${cur}" in
@@ -2061,6 +2077,7 @@ _brew_outdated() {
       --greedy-latest
       --help
       --json
+      --minimum-version
       --quiet
       --verbose
       "
@@ -3269,6 +3286,7 @@ _brew_upgrade() {
       --keyboard-layoutdir
       --language
       --mdimporterdir
+      --minimum-version
       --no-binaries
       --overwrite
       --prefpanedir
@@ -3457,6 +3475,7 @@ _brew() {
     --version) _brew___version ;;
     alias) _brew_alias ;;
     analytics) _brew_analytics ;;
+    as-console-user) _brew_as_console_user ;;
     audit) _brew_audit ;;
     autoremove) _brew_autoremove ;;
     bottle) _brew_bottle ;;

completions/fish/brew.fish

@@ -348,6 +348,13 @@ __fish_brew_complete_sub_arg 'analytics' 'off' -l quiet -d 'Make some output mor
 __fish_brew_complete_sub_arg 'analytics' 'off' -l verbose -d 'Make some output more verbose'
 
 
+__fish_brew_complete_cmd 'as-console-user' 'Run a Homebrew command as the active macOS console user'
+__fish_brew_complete_arg 'as-console-user' -l debug -d 'Display any debugging information'
+__fish_brew_complete_arg 'as-console-user' -l help -d 'Show this message'
+__fish_brew_complete_arg 'as-console-user' -l quiet -d 'Make some output more quiet'
+__fish_brew_complete_arg 'as-console-user' -l verbose -d 'Make some output more verbose'
+
+
 __fish_brew_complete_cmd 'audit' 'Check formula or cask for Homebrew coding style violations'
 __fish_brew_complete_arg 'audit' -l arch -d 'Audit the given CPU architecture. (Pass `all` to audit all architectures.)'
 __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
 __fish_brew_complete_arg 'outdated' -l greedy-latest -d 'Also include outdated casks including those with `version :latest`'
 __fish_brew_complete_arg 'outdated' -l help -d 'Show this message'
 __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'
+__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'
 __fish_brew_complete_arg 'outdated' -l quiet -d 'List only the names of outdated kegs (takes precedence over `--verbose`)'
 __fish_brew_complete_arg 'outdated' -l verbose -d 'Include detailed version information'
 __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
 __fish_brew_complete_arg 'upgrade' -l keyboard-layoutdir -d 'Target location for Keyboard Layouts (default: `/Library/Keyboard Layouts`)'
 __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'
 __fish_brew_complete_arg 'upgrade' -l mdimporterdir -d 'Target location for Spotlight Plugins (default: `~/Library/Spotlight`)'
+__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'
 __fish_brew_complete_arg 'upgrade' -l no-binaries -d 'Disable/enable linking of helper executables (default: enabled)'
 __fish_brew_complete_arg 'upgrade' -l overwrite -d 'Delete files that already exist in the prefix while linking'
 __fish_brew_complete_arg 'upgrade' -l prefpanedir -d 'Target location for Preference Panes (default: `~/Library/PreferencePanes`)'

completions/internal_commands_list.txt

@@ -8,6 +8,7 @@
 --version
 alias
 analytics
+as-console-user
 audit
 autoremove
 bottle

completions/zsh/_brew

@@ -143,6 +143,7 @@ __brew_internal_commands() {
     '--version:Print the version numbers of Homebrew, Homebrew/homebrew-core and Homebrew/homebrew-cask (if tapped) to standard output'
     'alias:Show an alias'\''s command'
     'analytics:Control Homebrew'\''s anonymous aggregate user behaviour analytics'
+    'as-console-user:Run a Homebrew command as the active macOS console user'
     'audit:Check formula or cask for Homebrew coding style violations'
     'autoremove:Uninstall formulae that were only installed as a dependency of another formula and are now no longer needed'
     'bottle:Generate a bottle (binary package) from a formula that was installed with `--build-bottle`'
@@ -451,6 +452,15 @@ off)
   esac
 }
 
+# brew as-console-user
+_brew_as_console_user() {
+  _arguments \
+    '--debug[Display any debugging information]' \
+    '--help[Show this message]' \
+    '--quiet[Make some output more quiet]' \
+    '--verbose[Make some output more verbose]'
+}
+
 # brew audit
 _brew_audit() {
   _arguments \
@@ -1713,6 +1723,7 @@ _brew_outdated() {
     '--greedy-latest[Also include outdated casks including those with `version :latest`]' \
     '--help[Show this message]' \
     '(--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]' \
+    '--minimum-version[Only list a named formula or cask with an installed version below the given minimum version]' \
     '(--verbose --json)--quiet[List only the names of outdated kegs (takes precedence over `--verbose`)]' \
     '(--quiet --json)--verbose[Include detailed version information]' \
     - formula \
@@ -2615,6 +2626,7 @@ _brew_upgrade() {
     '(--formula)--keyboard-layoutdir[Target location for Keyboard Layouts (default: `/Library/Keyboard Layouts`)]' \
     '(--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]' \
     '(--formula)--mdimporterdir[Target location for Spotlight Plugins (default: `~/Library/Spotlight`)]' \
+    '--minimum-version[Only upgrade a named formula or cask with an installed version below the given minimum version]' \
     '--no-binaries[Disable/enable linking of helper executables (default: enabled)]' \
     '(--cask)--overwrite[Delete files that already exist in the prefix while linking]' \
     '(--formula)--prefpanedir[Target location for Preference Panes (default: `~/Library/PreferencePanes`)]' \

docs/Manpage.md

@@ -133,6 +133,14 @@ Control Homebrew's anonymous aggregate user behaviour analytics. Read more at
 
 : Turn Homebrew's analytics off.
 
+### `as-console-user` *`command`* \[*`args`* ...\]
+
+Run a Homebrew command as the active macOS console user.
+
+This is intended for MDM, Munki and Jamf workflows where `brew` is invoked as
+root but Homebrew operations should run as the logged-in console user. The
+nested command is always dispatched through `HOMEBREW_BREW_FILE`.
+
 ### `autoremove` \[`--dry-run`\]
 
 Uninstall formulae that were only installed as a dependency of another formula
@@ -1516,6 +1524,11 @@ otherwise.
   deprecated and is currently the default if no version is specified. `v2`
   prints outdated formulae and casks.
 
+`--minimum-version`
+
+: Only list a named formula or cask with an installed version below the given
+  minimum version.
+
 `--fetch-HEAD`
 
 : 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.
 
 : Show what would be upgraded, but do not actually upgrade anything.
 
+`--minimum-version`
+
+: Only upgrade a named formula or cask with an installed version below the given
+  minimum version.
+
 `--ask`
 
 : Ask for confirmation before downloading and upgrading. Print the same plan as

manpages/brew.1

@@ -83,6 +83,10 @@ Turn Homebrew\[u2019]s analytics on\.
 .TP
 \fBbrew analytics off\fP
 Turn Homebrew\[u2019]s analytics off\.
+.SS "\fBas\-console\-user\fP \fIcommand\fP \fR[\fIargs\fP \.\.\.]"
+Run a Homebrew command as the active macOS console user\.
+.P
+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\&\.
 .SS "\fBautoremove\fP \fR[\fB\-\-dry\-run\fP]"
 Uninstall formulae that were only installed as a dependency of another formula and are now no longer needed\.
 .TP
@@ -973,6 +977,9 @@ List only outdated casks\.
 \fB\-\-json\fP
 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\.
 .TP
+\fB\-\-minimum\-version\fP
+Only list a named formula or cask with an installed version below the given minimum version\.
+.TP
 \fB\-\-fetch\-HEAD\fP
 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\.
 .TP
@@ -1347,6 +1354,9 @@ Print the verification and post\-install steps\.
 \fB\-n\fP, \fB\-\-dry\-run\fP
 Show what would be upgraded, but do not actually upgrade anything\.
 .TP
+\fB\-\-minimum\-version\fP
+Only upgrade a named formula or cask with an installed version below the given minimum version\.
+.TP
 \fB\-\-ask\fP
 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\.
 .TP