From ec69babd4406f768c974a9532fff7edf2604548e Mon Sep 17 00:00:00 2001
From: XuehaiPan <XuehaiPan@pku.edu.cn>
Date: Mon, 11 Oct 2021 17:10:19 +0800
Subject: [PATCH] man: update manpage and completions

---
 completions/bash/brew      | 1 +
 completions/fish/brew.fish | 1 +
 completions/zsh/_brew      | 1 +
 docs/Manpage.md            | 2 ++
 manpages/brew.1            | 4 ++++
 5 files changed, 9 insertions(+)

diff --git a/completions/bash/brew b/completions/bash/brew
index a5027e605e7eaa..c5b8e4c8bc55e8 100644
--- a/completions/bash/brew
+++ b/completions/bash/brew
@@ -1902,6 +1902,7 @@ _brew_tap() {
   case "${cur}" in
     -*)
       __brewcomp "
+      --custom-remote
       --debug
       --force-auto-update
       --full
diff --git a/completions/fish/brew.fish b/completions/fish/brew.fish
index 96b797f46a2850..97c303954816b7 100644
--- a/completions/fish/brew.fish
+++ b/completions/fish/brew.fish
@@ -1288,6 +1288,7 @@ __fish_brew_complete_arg 'style; and not __fish_seen_argument -l formula -l form
 
 
 __fish_brew_complete_cmd 'tap' 'Tap a formula repository'
+__fish_brew_complete_arg 'tap' -l custom-remote -d 'Force tap even if it is already installed. Useful for retapping with a new custom Git remote'
 __fish_brew_complete_arg 'tap' -l debug -d 'Display any debugging information'
 __fish_brew_complete_arg 'tap' -l force-auto-update -d 'Auto-update tap even if it is not hosted on GitHub. By default, only taps hosted on GitHub are auto-updated (for performance reasons)'
 __fish_brew_complete_arg 'tap' -l full -d 'Convert a shallow clone to a full clone without untapping. Taps are only cloned as shallow clones if `--shallow` was originally passed'
diff --git a/completions/zsh/_brew b/completions/zsh/_brew
index cd2342defa9410..85a416c7994c21 100644
--- a/completions/zsh/_brew
+++ b/completions/zsh/_brew
@@ -1579,6 +1579,7 @@ _brew_style() {
 # brew tap
 _brew_tap() {
   _arguments \
+    '--custom-remote[Force tap even if it is already installed. Useful for retapping with a new custom Git remote]' \
     '--debug[Display any debugging information]' \
     '--force-auto-update[Auto-update tap even if it is not hosted on GitHub. By default, only taps hosted on GitHub are auto-updated (for performance reasons)]' \
     '--full[Convert a shallow clone to a full clone without untapping. Taps are only cloned as shallow clones if `--shallow` was originally passed]' \
diff --git a/docs/Manpage.md b/docs/Manpage.md
index 05e472065a17e6..2bd0a6dd0f3123 100644
--- a/docs/Manpage.md
+++ b/docs/Manpage.md
@@ -600,6 +600,8 @@ using protocols other than HTTPS, e.g. SSH, git, HTTP, FTP(S), rsync.
   Fetch tap as a shallow clone rather than a full clone. Useful for continuous integration.
 * `--force-auto-update`:
   Auto-update tap even if it is not hosted on GitHub. By default, only taps hosted on GitHub are auto-updated (for performance reasons).
+* `--custom-remote`:
+  Force tap even if it is already installed. Useful for retapping with a new custom Git remote.
 * `--repair`:
   Migrate tapped formulae from symlink-based to directory-based structure.
 * `--list-pinned`:
diff --git a/manpages/brew.1 b/manpages/brew.1
index 9a5c762d48f08a..7ff8478d7029f7 100644
--- a/manpages/brew.1
+++ b/manpages/brew.1
@@ -831,6 +831,10 @@ Fetch tap as a shallow clone rather than a full clone\. Useful for continuous in
 Auto\-update tap even if it is not hosted on GitHub\. By default, only taps hosted on GitHub are auto\-updated (for performance reasons)\.
 .
 .TP
+\fB\-\-custom\-remote\fR
+Force tap even if it is already installed\. Useful for retapping with a new custom Git remote\.
+.
+.TP
 \fB\-\-repair\fR
 Migrate tapped formulae from symlink\-based to directory\-based structure\.
 .