mxcl/homebrew — Issue #10699: Man page is ambiguous about --verbose, -v and --version
Author: polrop
Created: 2012-03-05 18:10:55+00:00
State: open

Hi,

Here the part I find ambiguous:
```
SYNOPSIS
brew [--verbose|-v] command [options] [formula] ...
brew [--version|-v]
```
The second form works perfectly:
```
$ brew --version
0.8.1
$ brew -v
0.8.1
```
But the first have some problem:
```
$ brew list asciidoc
/usr/local/Cellar/asciidoc/8.6.6/bin/asciidoc.py
/usr/local/Cellar/asciidoc/8.6.6/bin/asciidoc
/usr/local/Cellar/asciidoc/8.6.6/bin/a2x.py
/usr/local/Cellar/asciidoc/8.6.6/bin/a2x
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/ (79 files)
/usr/local/Cellar/asciidoc/8.6.6/share/man/ (2 files)
$ brew -v list asciidoc
Homebrew 0.8.1
asciidoc 8.6.6
$ brew --verbose list asciidoc
Error: Unknown command: --verbose
$ brew list --verbose asciidoc
/usr/local/Cellar/asciidoc/8.6.6/bin/a2x
/usr/local/Cellar/asciidoc/8.6.6/bin/a2x.py
/usr/local/Cellar/asciidoc/8.6.6/bin/asciidoc
/usr/local/Cellar/asciidoc/8.6.6/bin/asciidoc.py
/usr/local/Cellar/asciidoc/8.6.6/ChangeLog
/usr/local/Cellar/asciidoc/8.6.6/COPYING
/usr/local/Cellar/asciidoc/8.6.6/COPYRIGHT
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/asciidoc.conf
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/dblatex/asciidoc-dblatex.sty
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/dblatex/asciidoc-dblatex.xsl
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/docbook-xsl/chunked.xsl
/usr/local/Cellar/asciidoc/8.6.6/etc/asciidoc/docbook-xsl/common.xsl
[snip]
$ brew -v list --verbose asciidoc
Homebrew 0.8.1
asciidoc 8.6.6
$ brew --verbose list --verbose asciidoc
Error: Unknown command: --verbose
Kernel.exit
```
So If I understand well the first verbose option (before the sub command) tells brew to be verbose and the second only tells it to the sub command. What I don't understand is the error reported in some cases. Maybe using `-V` as an alias for `--version` would help.

Regards,
-Nico