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

Update manpage and completions.

completions/bash/brew

@@ -818,6 +818,7 @@ _brew_contributions() {
       --debug
       --from
       --help
+      --organisation
       --quiet
       --repositories
       --to

completions/fish/brew.fish

@@ -602,8 +602,9 @@ __fish_brew_complete_arg 'contributions' -l csv -d 'Print a CSV of contributions
 __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. Omitting this flag searches the past year'
 __fish_brew_complete_arg 'contributions' -l help -d 'Show this message'
+__fish_brew_complete_arg 'contributions' -l organisation -d 'Specify the organisation to populate sources repositories from. Omitting this flag searches the Homebrew primary repositories'
 __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 list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all` searches all repositories. '
+__fish_brew_complete_arg 'contributions' -l repositories -d 'Specify a comma-separated list of repositories to search. All repositories must be under the same user or organisation. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `Homebrew/brew`, `Homebrew/homebrew-core`, `Homebrew/homebrew-cask`. Specifying `--repositories=all` searches all non-deprecated Homebrew repositories. '
 __fish_brew_complete_arg 'contributions' -l to -d 'Date (ISO 8601 format) to stop searching contributions'
 __fish_brew_complete_arg 'contributions' -l user -d 'Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches Homebrew maintainers'
 __fish_brew_complete_arg 'contributions' -l verbose -d 'Make some output more verbose'

completions/zsh/_brew

@@ -769,8 +769,9 @@ _brew_contributions() {
     '--debug[Display any debugging information]' \
     '--from[Date (ISO 8601 format) to start searching contributions. Omitting this flag searches the past year]' \
     '--help[Show this message]' \
+    '(--repositories)--organisation[Specify the organisation to populate sources repositories from. Omitting this flag searches the Homebrew primary repositories]' \
     '--quiet[Make some output more quiet]' \
-    '--repositories[Specify a comma-separated list of repositories to search. Supported repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all` searches all repositories. ]' \
+    '(--organisation)--repositories[Specify a comma-separated list of repositories to search. All repositories must be under the same user or organisation. Omitting this flag, or specifying `--repositories=primary`, searches only the main repositories: `Homebrew/brew`, `Homebrew/homebrew-core`, `Homebrew/homebrew-cask`. Specifying `--repositories=all` searches all non-deprecated Homebrew repositories. ]' \
     '--to[Date (ISO 8601 format) to stop searching contributions]' \
     '--user[Specify a comma-separated list of GitHub usernames or email addresses to find contributions from. Omitting this flag searches Homebrew maintainers]' \
     '--verbose[Make some output more verbose]'

docs/Manpage.md

@@ -2414,11 +2414,17 @@ Summarise contributions to Homebrew repositories.
 
 `--repositories`
 
-: Specify a comma-separated list of repositories to search. Supported
-  repositories: `brew`, `core`, `cask`, `command-not-found` and `test-bot`.
-  Omitting this flag, or specifying `--repositories=primary`, searches only the
-  main repositories: `brew`, `core`, `cask`. Specifying `--repositories=all`
-  searches all repositories.
+: Specify a comma-separated list of repositories to search. All repositories
+  must be under the same user or organisation. Omitting this flag, or specifying
+  `--repositories=primary`, searches only the main repositories:
+  `Homebrew/brew`, `Homebrew/homebrew-core`, `Homebrew/homebrew-cask`.
+  Specifying `--repositories=all` searches all non-deprecated Homebrew
+  repositories.
+
+`--organisation`
+
+: Specify the organisation to populate sources repositories from. Omitting this
+  flag searches the Homebrew primary repositories.
 
 `--from`
 

manpages/brew.1

@@ -1515,7 +1515,10 @@ Summarise contributions to Homebrew repositories\.
 Specify a comma\-separated list of GitHub usernames or email addresses to find contributions from\. Omitting this flag searches Homebrew maintainers\.
 .TP
 \fB\-\-repositories\fP
-Specify a comma\-separated list of repositories to search\. Supported repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP, \fBcommand\-not\-found\fP and \fBtest\-bot\fP\&\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: \fBbrew\fP, \fBcore\fP, \fBcask\fP\&\. Specifying \fB\-\-repositories=all\fP searches all repositories\.
+Specify a comma\-separated list of repositories to search\. All repositories must be under the same user or organisation\. Omitting this flag, or specifying \fB\-\-repositories=primary\fP, searches only the main repositories: \fBHomebrew/brew\fP, \fBHomebrew/homebrew\-core\fP, \fBHomebrew/homebrew\-cask\fP\&\. Specifying \fB\-\-repositories=all\fP searches all non\-deprecated Homebrew repositories\.
+.TP
+\fB\-\-organisation\fP
+Specify the organisation to populate sources repositories from\. Omitting this flag searches the Homebrew primary repositories\.
 .TP
 \fB\-\-from\fP
 Date (ISO 8601 format) to start searching contributions\. Omitting this flag searches the past year\.