aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJack Nagel2011-09-08 21:06:50 -0500
committerJack Nagel2011-09-08 21:10:44 -0500
commit2183372f655d44c77fb177e254ea0e054c729330 (patch)
tree8115dff4388011a86d07b9e00e487cae1ac0c55d
parent16faf0684af102341fc9ed32e8c98b8095b9a2e9 (diff)
downloadbrew-2183372f655d44c77fb177e254ea0e054c729330.tar.bz2
Man page: clarify `list` command
Document the '--versions' option for `brew list`. The two forms of the `list` command as previously documented clearly do different things, but after documenting '--versions', their functions do overlap a bit, so we combine them and clarify the different invocations. Signed-off-by: Jack Nagel <jacknagel@gmail.com>
-rw-r--r--Library/Contributions/manpages/brew.1.md10
-rw-r--r--share/man/man1/brew.112
2 files changed, 13 insertions, 9 deletions
diff --git a/Library/Contributions/manpages/brew.1.md b/Library/Contributions/manpages/brew.1.md
index ab3cb9a27..ef991dffa 100644
--- a/Library/Contributions/manpages/brew.1.md
+++ b/Library/Contributions/manpages/brew.1.md
@@ -164,11 +164,13 @@ For the full command list, see the COMMANDS section.
is done automatically when you install formula, but can be useful for DIY
installations.
- * `list`:
- List all installed formulae.
+ * `list [--versions]` [<formulae>]:
+ Without any arguments, list all installed formulae.
+
+ If <formulae> are given, list the installed files for <formulae>.
- * `list` <formula>:
- List the installed files for <formula>.
+ If `--versions` is passed, show the version number for installed formulae,
+ or only the specified formulae if <formulae> are given.
* `log [git-log-options]` <formula> ...:
Show the git log for the given formulae. Options that `git-log`(1)
diff --git a/share/man/man1/brew.1 b/share/man/man1/brew.1
index 2f37e68cc..d2a72844a 100644
--- a/share/man/man1/brew.1
+++ b/share/man/man1/brew.1
@@ -181,12 +181,14 @@ If \fB\-\-git\fR is passed, Homebrew will create a Git repository, useful for cr
Symlink all of \fIformula\fR\'s installed files into the Homebrew prefix\. This is done automatically when you install formula, but can be useful for DIY installations\.
.
.TP
-\fBlist\fR
-List all installed formulae\.
+\fBlist [\-\-versions]\fR [\fIformulae\fR]
+Without any arguments, list all installed formulae\.
.
-.TP
-\fBlist\fR \fIformula\fR
-List the installed files for \fIformula\fR\.
+.IP
+If \fIformulae\fR are given, list the installed files for \fIformulae\fR\.
+.
+.IP
+If \fB\-\-versions\fR is passed, show the version number for installed formulae, or only the specified formulae if \fIformulae\fR are given\.
.
.TP
\fBlog [git\-log\-options]\fR \fIformula\fR \.\.\.