Merge pull request #13641 from Homebrew/update-man-completions

Update maintainers, manpage and completions.

completions/bash/brew

@@ -670,6 +670,25 @@ _brew_config() {
   esac
 }
 
+_brew_contributions() {
+  local cur="${COMP_WORDS[COMP_CWORD]}"
+  case "${cur}" in
+    -*)
+      __brewcomp "
+      --debug
+      --from
+      --help
+      --quiet
+      --repositories
+      --to
+      --verbose
+      "
+      return
+      ;;
+    *)
+  esac
+}
+
 _brew_create() {
   local cur="${COMP_WORDS[COMP_CWORD]}"
   case "${cur}" in
@@ -2479,6 +2498,7 @@ _brew() {
     commands) _brew_commands ;;
     completions) _brew_completions ;;
     config) _brew_config ;;
+    contributions) _brew_contributions ;;
     create) _brew_create ;;
     deps) _brew_deps ;;
     desc) _brew_desc ;;

completions/fish/brew.fish

@@ -529,6 +529,16 @@ __fish_brew_complete_arg 'config' -l quiet -d 'Make some output more quiet'
 __fish_brew_complete_arg 'config' -l verbose -d 'Make some output more verbose'
 
 
+__fish_brew_complete_cmd 'contributions' 'Contributions to Homebrew repos for a user'
+__fish_brew_complete_arg 'contributions' -l debug -d 'Display any debugging information'
+__fish_brew_complete_arg 'contributions' -l from -d 'Date (ISO-8601 format) to start searching contributions'
+__fish_brew_complete_arg 'contributions' -l help -d 'Show this message'
+__fish_brew_complete_arg 'contributions' -l quiet -d 'Make some output more quiet'
+__fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated (no spaces) list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `autoupdate`, `bundle`, `command-not-found`, `test-bot`, `services`, `cask-drivers`, `cask-fonts` and `cask-versions`.Omitting this flag, or specifying `--repositories=all`, will search all repositories'
+__fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO-8601 format) to stop searching contributions'
+__fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose'
+
+
 __fish_brew_complete_cmd 'create' 'Generate a formula or, with `--cask`, a cask for the downloadable file at URL and open it in the editor'
 __fish_brew_complete_arg 'create' -l HEAD -d 'Indicate that URL points to the package\'s repository rather than a file'
 __fish_brew_complete_arg 'create' -l autotools -d 'Create a basic template for an Autotools-style build'

completions/internal_commands_list.txt

@@ -26,6 +26,7 @@ command
 commands
 completions
 config
+contributions
 create
 deps
 desc

completions/zsh/_brew

@@ -152,6 +152,7 @@ __brew_internal_commands() {
     'commands:Show lists of built-in and external commands'
     'completions:Control whether Homebrew automatically links external tap shell completion files'
     'config:Show Homebrew and system configuration info useful for debugging'
+    'contributions:Contributions to Homebrew repos for a user'
     'create:Generate a formula or, with `--cask`, a cask for the downloadable file at URL and open it in the editor'
     'deps:Show dependencies for formula'
     'desc:Display formula'\''s name and one-line description'
@@ -652,6 +653,18 @@ _brew_config() {
     '--verbose[Make some output more verbose]'
 }
 
+# brew contributions
+_brew_contributions() {
+  _arguments \
+    '--debug[Display any debugging information]' \
+    '--from[Date (ISO-8601 format) to start searching contributions]' \
+    '--help[Show this message]' \
+    '--quiet[Make some output more quiet]' \
+    '--repositories[Specify a comma-separated (no spaces) list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `autoupdate`, `bundle`, `command-not-found`, `test-bot`, `services`, `cask-drivers`, `cask-fonts` and `cask-versions`.Omitting this flag, or specifying `--repositories=all`, will search all repositories]' \
+    '--to[Date (ISO-8601 format) to stop searching contributions]' \
+    '--verbose[Make some output more verbose]'
+}
+
 # brew create
 _brew_create() {
   _arguments \

docs/Manpage.md

@@ -1081,6 +1081,19 @@ Display the source of a *`formula`* or *`cask`*.
 
 Display the path to the file being used when invoking `brew` *`cmd`*.
 
+### `contributions` *`email|name`* [*`--repositories`*`=`]
+
+Contributions to Homebrew repos for a user.
+
+The first argument is a name (e.g. "BrewTestBot") or an email address (e.g. "brewtestbot@brew.sh").
+
+* `--repositories`:
+  Specify a comma-separated (no spaces) list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `aliases`, `autoupdate`, `bundle`, `command-not-found`, `test-bot`, `services`, `cask-drivers`, `cask-fonts` and `cask-versions`.Omitting this flag, or specifying `--repositories=all`, will search all repositories.
+* `--from`:
+  Date (ISO-8601 format) to start searching contributions.
+* `--to`:
+  Date (ISO-8601 format) to stop searching contributions.
+
 ### `create` [*`options`*] *`URL`*
 
 Generate a formula or, with `--cask`, a cask for the downloadable file at *`URL`*

manpages/brew.1

@@ -1539,6 +1539,24 @@ Treat all named arguments as casks\.
 .SS "\fBcommand\fR \fIcommand\fR [\.\.\.]"
 Display the path to the file being used when invoking \fBbrew\fR \fIcmd\fR\.
 .
+.SS "\fBcontributions\fR \fIemail|name\fR [\fI\-\-repositories\fR\fB=\fR]"
+Contributions to Homebrew repos for a user\.
+.
+.P
+The first argument is a name (e\.g\. "BrewTestBot") or an email address (e\.g\. "brewtestbot@brew\.sh")\.
+.
+.TP
+\fB\-\-repositories\fR
+Specify a comma\-separated (no spaces) list of repositories to search\. Supported repositories: \fBbrew\fR, \fBcore\fR, \fBcask\fR, \fBaliases\fR, \fBautoupdate\fR, \fBbundle\fR, \fBcommand\-not\-found\fR, \fBtest\-bot\fR, \fBservices\fR, \fBcask\-drivers\fR, \fBcask\-fonts\fR and \fBcask\-versions\fR\.Omitting this flag, or specifying \fB\-\-repositories=all\fR, will search all repositories\.
+.
+.TP
+\fB\-\-from\fR
+Date (ISO\-8601 format) to start searching contributions\.
+.
+.TP
+\fB\-\-to\fR
+Date (ISO\-8601 format) to stop searching contributions\.
+.
 .SS "\fBcreate\fR [\fIoptions\fR] \fIURL\fR"
 Generate a formula or, with \fB\-\-cask\fR, a cask for the downloadable file at \fIURL\fR and open it in the editor\. Homebrew will attempt to automatically derive the formula name and version, but if it fails, you\'ll have to make your own template\. The \fBwget\fR formula serves as a simple example\. For the complete API, see: \fIhttps://rubydoc\.brew\.sh/Formula\fR
 .