From 154acf8b1faa11f748cd882287e922b3d7ea5739 Mon Sep 17 00:00:00 2001
From: BrewTestBot <1589480+BrewTestBot@users.noreply.github.com>
Date: Mon, 12 Sep 2022 13:56:29 +0000
Subject: [PATCH] Update manpage and completions.

Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
---
 completions/bash/brew                  | 17 +++++++++++++++++
 completions/fish/brew.fish             |  7 +++++++
 completions/internal_commands_list.txt |  1 +
 completions/zsh/_brew                  | 10 ++++++++++
 docs/Manpage.md                        |  4 ++++
 manpages/brew.1                        |  3 +++
 6 files changed, 42 insertions(+)

diff --git a/completions/bash/brew b/completions/bash/brew
index 34ba987107..10cd747cb7 100644
--- a/completions/bash/brew
+++ b/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 ;;
diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index b425fad62b..4b54f2d4d4 100644
--- a/completions/fish/brew.fish
+++ b/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'
diff --git a/completions/internal_commands_list.txt b/completions/internal_commands_list.txt
index 7e74430e25..d4f8179037 100644
--- a/completions/internal_commands_list.txt
+++ b/completions/internal_commands_list.txt
@@ -32,6 +32,7 @@ deps
 desc
 developer
 dispatch-build-bottle
+docs
 doctor
 dr
 edit
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index bd5a62d9f4..e219390246 100644
--- a/completions/zsh/_brew
+++ b/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 \
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 34c84e132c..1d82739b95 100644
--- a/docs/Manpage.md
+++ b/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
diff --git a/manpages/brew.1 b/manpages/brew.1
index cf6483e085..796baa506a 100644
--- a/manpages/brew.1
+++ b/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\.
 .