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>
This commit is contained in:
Jack Nagel 2011-09-08 21:06:50 -05:00
parent 16faf0684a
commit 2183372f65
2 changed files with 13 additions and 9 deletions

View File

@ -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 is done automatically when you install formula, but can be useful for DIY
installations. installations.
* `list`: * `list [--versions]` [<formulae>]:
List all installed formulae. Without any arguments, list all installed formulae.
* `list` <formula>: If <formulae> are given, list the installed files for <formulae>.
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> ...: * `log [git-log-options]` <formula> ...:
Show the git log for the given formulae. Options that `git-log`(1) Show the git log for the given formulae. Options that `git-log`(1)

View File

@ -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\. 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 .TP
\fBlist\fR \fBlist [\-\-versions]\fR [\fIformulae\fR]
List all installed formulae\. Without any arguments, list all installed formulae\.
. .
.TP .IP
\fBlist\fR \fIformula\fR If \fIformulae\fR are given, list the installed files for \fIformulae\fR\.
List the installed files for \fIformula\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 .TP
\fBlog [git\-log\-options]\fR \fIformula\fR \.\.\. \fBlog [git\-log\-options]\fR \fIformula\fR \.\.\.