diff --git a/completions/bash/brew b/completions/bash/brew index aae51371d9..a279d4abb5 100644 --- a/completions/bash/brew +++ b/completions/bash/brew @@ -687,6 +687,7 @@ _brew_contributions() { --quiet --repositories --to + --user --verbose " return diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish index 31a476e4c1..2cb0882fa4 100644 --- a/completions/fish/brew.fish +++ b/completions/fish/brew.fish @@ -536,7 +536,7 @@ __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_cmd 'contributions' 'Contributions to Homebrew repos' __fish_brew_complete_arg 'contributions' -l csv -d 'Print a CSV of a user\'s contributions across repositories over the time period' __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' @@ -544,6 +544,7 @@ __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`, searches all repositories. Use `--repositories=primary` to search only the main repositories: brew,core,cask' __fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO-8601 format) to stop searching contributions' +__fish_brew_complete_arg 'contributions' -l user -d 'A GitHub username or email address of a specific person to find contribution data for' __fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose' diff --git a/completions/zsh/_brew b/completions/zsh/_brew index 26ec6c2933..bef4afc29e 100644 --- a/completions/zsh/_brew +++ b/completions/zsh/_brew @@ -154,7 +154,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' + 'contributions:Contributions to Homebrew repos' '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' @@ -671,6 +671,7 @@ _brew_contributions() { '--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`, searches all repositories. Use `--repositories=primary` to search only the main repositories: brew,core,cask]' \ '--to[Date (ISO-8601 format) to stop searching contributions]' \ + '--user[A GitHub username or email address of a specific person to find contribution data for]' \ '--verbose[Make some output more verbose]' } diff --git a/docs/Manpage.md b/docs/Manpage.md index 38e6b381d9..b7c13df6f1 100644 --- a/docs/Manpage.md +++ b/docs/Manpage.md @@ -1111,11 +1111,9 @@ Display the source of a *`formula`* or *`cask`*. Display the path to the file being used when invoking `brew` *`cmd`*. -### `contributions` *`email|username`* [*`--repositories`*`=`] [*`--csv`*] +### `contributions` [--user=*`email|username`*] [*`--repositories`*`=`] [*`--csv`*] -Contributions to Homebrew repos for a user. - -The first argument is a GitHub username (e.g. "BrewTestBot") or an email address (e.g. "brewtestbot@brew.sh"). +Contributions to Homebrew repos. * `--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`, searches all repositories. Use `--repositories=primary` to search only the main repositories: brew,core,cask. @@ -1123,6 +1121,8 @@ The first argument is a GitHub username (e.g. "BrewTestBot") or an email address Date (ISO-8601 format) to start searching contributions. * `--to`: Date (ISO-8601 format) to stop searching contributions. +* `--user`: + A GitHub username or email address of a specific person to find contribution data for. * `--csv`: Print a CSV of a user's contributions across repositories over the time period. diff --git a/manpages/brew.1 b/manpages/brew.1 index 4b91240b62..ac1e80162a 100644 --- a/manpages/brew.1 +++ b/manpages/brew.1 @@ -1598,11 +1598,8 @@ 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|username\fR [\fI\-\-repositories\fR\fB=\fR] [\fI\-\-csv\fR]" -Contributions to Homebrew repos for a user\. -. -.P -The first argument is a GitHub username (e\.g\. "BrewTestBot") or an email address (e\.g\. "brewtestbot@brew\.sh")\. +.SS "\fBcontributions\fR [\-\-user=\fIemail|username\fR] [\fI\-\-repositories\fR\fB=\fR] [\fI\-\-csv\fR]" +Contributions to Homebrew repos\. . .TP \fB\-\-repositories\fR @@ -1617,6 +1614,10 @@ Date (ISO\-8601 format) to start searching contributions\. Date (ISO\-8601 format) to stop searching contributions\. . .TP +\fB\-\-user\fR +A GitHub username or email address of a specific person to find contribution data for\. +. +.TP \fB\-\-csv\fR Print a CSV of a user\'s contributions across repositories over the time period\. .