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

Update manpage and completions.

completions/bash/brew

@@ -828,6 +828,22 @@ _brew_dispatch_build_bottle() {
   __brew_complete_formulae
 }
 
+_brew_docs() {
+  local cur="${COMP_WORDS[COMP_CWORD]}"
+  case "${cur}" in
+    -*)
+      __brewcomp "
+      --debug
+      --help
+      --quiet
+      --verbose
+      "
+      return
+      ;;
+    *)
+  esac
+}
+
 _brew_doctor() {
   local cur="${COMP_WORDS[COMP_CWORD]}"
   case "${cur}" in
@@ -2512,6 +2528,7 @@ _brew() {
     desc) _brew_desc ;;
     developer) _brew_developer ;;
     dispatch-build-bottle) _brew_dispatch_build_bottle ;;
+    docs) _brew_docs ;;
     doctor) _brew_doctor ;;
     dr) _brew_dr ;;
     edit) _brew_edit ;;

completions/fish/brew.fish

@@ -635,6 +635,13 @@ __fish_brew_complete_arg 'dispatch-build-bottle' -l workflow -d 'Dispatch specif
 __fish_brew_complete_arg 'dispatch-build-bottle' -a '(__fish_brew_suggest_formulae_all)'
 
 
+__fish_brew_complete_cmd 'docs' 'Open Homebrew\'s online documentation (https://docs'
+__fish_brew_complete_arg 'docs' -l debug -d 'Display any debugging information'
+__fish_brew_complete_arg 'docs' -l help -d 'Show this message'
+__fish_brew_complete_arg 'docs' -l quiet -d 'Make some output more quiet'
+__fish_brew_complete_arg 'docs' -l verbose -d 'Make some output more verbose'
+
+
 __fish_brew_complete_cmd 'doctor' 'Check your system for potential problems'
 __fish_brew_complete_arg 'doctor' -l audit-debug -d 'Enable debugging and profiling of audit methods'
 __fish_brew_complete_arg 'doctor' -l debug -d 'Display any debugging information'

completions/internal_commands_list.txt

@@ -32,6 +32,7 @@ deps
 desc
 developer
 dispatch-build-bottle
+docs
 doctor
 dr
 edit

completions/zsh/_brew

@@ -158,6 +158,7 @@ __brew_internal_commands() {
     'desc:Display formula'\''s name and one-line description'
     'developer:Control Homebrew'\''s developer mode'
     'dispatch-build-bottle:Build bottles for these formulae with GitHub Actions'
+    'docs:Open Homebrew'\''s online documentation (https://docs'
     'doctor:Check your system for potential problems'
     'edit:Open a formula or cask in the editor set by `EDITOR` or `HOMEBREW_EDITOR`, or open the Homebrew repository for editing if no formula is provided'
     'extract:Look through repository history to find the most recent version of formula and create a copy in tap'
@@ -775,6 +776,15 @@ _brew_dispatch_build_bottle() {
     '*::formula:__brew_formulae'
 }
 
+# brew docs
+_brew_docs() {
+  _arguments \
+    '--debug[Display any debugging information]' \
+    '--help[Show this message]' \
+    '--quiet[Make some output more quiet]' \
+    '--verbose[Make some output more verbose]'
+}
+
 # brew doctor
 _brew_doctor() {
   _arguments \

docs/Manpage.md

@@ -207,6 +207,10 @@ branch instead of the latest stable version along with some other behaviour chan
 `brew developer` (`on`|`off`)
 <br>Turn Homebrew's developer mode on or off respectively.
 
+### `docs`
+
+Open Homebrew's online documentation (https://docs.brew.sh) in a browser.
+
 ### `doctor`, `dr` [*`--list-checks`*] [*`--audit-debug`*] [*`diagnostic_check`* ...]
 
 Check your system for potential problems. Will exit with a non-zero status

manpages/brew.1

@@ -263,6 +263,9 @@ Control Homebrew\'s developer mode\. When developer mode is enabled, \fBbrew upd
 \fBbrew developer\fR (\fBon\fR|\fBoff\fR)
     Turn Homebrew\'s developer mode on or off respectively\.
 .
+.SS "\fBdocs\fR"
+Open Homebrew\'s online documentation (https://docs\.brew\.sh) in a browser\.
+.
 .SS "\fBdoctor\fR, \fBdr\fR [\fI\-\-list\-checks\fR] [\fI\-\-audit\-debug\fR] [\fIdiagnostic_check\fR \.\.\.]"
 Check your system for potential problems\. Will exit with a non\-zero status if any potential problems are found\. Please note that these warnings are just used to help the Homebrew maintainers with debugging if you file an issue\. If everything you use Homebrew for is working fine: please don\'t worry or file an issue; just ignore this\.
 .