tap-info: expand and correct help text

3 files changed, 20 insertions, 5 deletions

diff --git a/Library/Homebrew/cmd/tap-info.rb b/Library/Homebrew/cmd/tap-info.rb
index 178c344f9..a86aa14c6 100644
--- a/Library/Homebrew/cmd/tap-info.rb
+++ b/Library/Homebrew/cmd/tap-info.rb
@@ -1,5 +1,10 @@
-#:  * `tap-info` <tap>:
-#:    Display information about <tap>.
+#:  * `tap-info`:
+#:    Display a brief summary of all installed taps.
+#:
+#:  * `tap-info` (`--installed`|<taps>):
+#:    Display detailed information about one or more <taps>.
+#:
+#:    Pass `--installed` to display information on all installed taps.
 #:
 #:  * `tap-info` `--json=`<version> (`--installed`|<taps>):
 #:    Print a JSON representation of <taps>. Currently the only accepted value
diff --git a/share/doc/homebrew/brew.1.html b/share/doc/homebrew/brew.1.html
index 44295b3f9..5951ade59 100644
--- a/share/doc/homebrew/brew.1.html
+++ b/share/doc/homebrew/brew.1.html
@@ -369,7 +369,10 @@ However, retapping with a different <var>URL</var> will cause an exception, so f
 <dt><code>tap</code> <code>--repair</code></dt><dd><p>Migrate tapped formulae from symlink-based to directory-based structure.</p></dd>
 <dt><code>tap</code> <code>--list-official</code></dt><dd><p>List all official taps.</p></dd>
 <dt><code>tap</code> <code>--list-pinned</code></dt><dd><p>List all pinned taps.</p></dd>
-<dt><code>tap-info</code> <var>tap</var></dt><dd><p>Display information about <var>tap</var>.</p></dd>
+<dt><code>tap-info</code></dt><dd><p>Display a brief summary of all installed taps.</p></dd>
+<dt><code>tap-info</code> (<code>--installed</code>|<var>taps</var>)</dt><dd><p>Display detailed information about one or more <var>taps</var>.</p>
+
+<p>Pass <code>--installed</code> to display information on all installed taps.</p></dd>
 <dt><code>tap-info</code> <code>--json=</code><var>version</var> (<code>--installed</code>|<var>taps</var>)</dt><dd><p>Print a JSON representation of <var>taps</var>. Currently the only accepted value
 for <var>version</var> is <code>v1</code>.</p>
 
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index fbed32fa0..d7172aad9 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -503,8 +503,15 @@ List all official taps\.
 List all pinned taps\.
 .
 .TP
-\fBtap\-info\fR \fItap\fR
-Display information about \fItap\fR\.
+\fBtap\-info\fR
+Display a brief summary of all installed taps\.
+.
+.TP
+\fBtap\-info\fR (\fB\-\-installed\fR|\fItaps\fR)
+Display detailed information about one or more \fItaps\fR\.
+.
+.IP
+Pass \fB\-\-installed\fR to display information on all installed taps\.
 .
 .TP
 \fBtap\-info\fR \fB\-\-json=\fR\fIversion\fR (\fB\-\-installed\fR|\fItaps\fR)