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

Update manpage and completions.

Author: issyl0

completions/bash/brew

@@ -853,6 +853,7 @@ _brew_contributions() {
       --from
       --help
       --organisation
+      --quarter
       --quiet
       --repositories
       --team

completions/fish/brew.fish

@@ -619,6 +619,7 @@ __fish_brew_complete_arg 'contributions' -l debug -d 'Display any debugging info
 __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 quarter -d 'Quarter to search (1-4). Omitting this flag searches the past year. If `--from` or `--to` are set, they take precedence'
 __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. 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`'
 __fish_brew_complete_arg 'contributions' -l team -d 'Specify the team to populate users from. The first part of the team name will be used as the organisation'

completions/zsh/_brew

@@ -796,6 +796,7 @@ _brew_contributions() {
     '--from[Date (ISO 8601 format) to start searching contributions. Omitting this flag searches the past year]' \
     '--help[Show this message]' \
     '(--repositories --team)--organisation[Specify the organisation to populate sources repositories from. Omitting this flag searches the Homebrew primary repositories]' \
+    '--quarter[Quarter to search (1-4). Omitting this flag searches the past year. If `--from` or `--to` are set, they take precedence]' \
     '--quiet[Make some output more quiet]' \
     '(--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`]' \
     '(--organisation --user)--team[Specify the team to populate users from. The first part of the team name will be used as the organisation]' \

docs/Manpage.md

@@ -2420,7 +2420,7 @@ Display the source of a *`formula`* or *`cask`*.
 
 : Treat all named arguments as casks.
 
-### `contributions` \[`--user=`\] \[`--repositories=`\] \[`--from=`\] \[`--to=`\] \[`--csv`\]
+### `contributions` \[`--user=`\] \[`--repositories=`\] \[`--quarter=`\] \[`--from=`\] \[`--to=`\] \[`--csv`\]
 
 Summarise contributions to Homebrew repositories.
 
@@ -2446,6 +2446,11 @@ Summarise contributions to Homebrew repositories.
 : Specify the team to populate users from. The first part of the team name will
   be used as the organisation.
 
+`--quarter`
+
+: Quarter to search (1-4). Omitting this flag searches the past year. If
+  `--from` or `--to` are set, they take precedence.
+
 `--from`
 
 : Date (ISO 8601 format) to start searching contributions. Omitting this flag

manpages/brew.1

@@ -1519,7 +1519,7 @@ Treat all named arguments as formulae\.
 .TP
 \fB\-\-cask\fP
 Treat all named arguments as casks\.
-.SS "\fBcontributions\fP \fR[\fB\-\-user=\fP] \fR[\fB\-\-repositories=\fP] \fR[\fB\-\-from=\fP] \fR[\fB\-\-to=\fP] \fR[\fB\-\-csv\fP]"
+.SS "\fBcontributions\fP \fR[\fB\-\-user=\fP] \fR[\fB\-\-repositories=\fP] \fR[\fB\-\-quarter=\fP] \fR[\fB\-\-from=\fP] \fR[\fB\-\-to=\fP] \fR[\fB\-\-csv\fP]"
 Summarise contributions to Homebrew repositories\.
 .TP
 \fB\-\-user\fP
@@ -1534,6 +1534,9 @@ Specify the organisation to populate sources repositories from\. Omitting this f
 \fB\-\-team\fP
 Specify the team to populate users from\. The first part of the team name will be used as the organisation\.
 .TP
+\fB\-\-quarter\fP
+Quarter to search (1\-4)\. Omitting this flag searches the past year\. If \fB\-\-from\fP or \fB\-\-to\fP are set, they take precedence\.
+.TP
 \fB\-\-from\fP
 Date (ISO 8601 format) to start searching contributions\. Omitting this flag searches the past year\.
 .TP