cmd/list: add common ls options.

We need to manually specify these now so let's add a few that we'd
either previously documented or we've caught being used in the wild and
adjust the documentation accordingly.
This commit is contained in:
Mike McQuaid 2018-05-29 18:45:46 +01:00
parent 315ccf604f
commit f8f77ea52d
3 changed files with 13 additions and 8 deletions

View File

@ -1,7 +1,7 @@
#: * `list`, `ls` [`--full-name`]: #: * `list`, `ls` [`--full-name`] [`-1`] [`-l`] [`-t`] [`-r`]:
#: List all installed formulae. If `--full-name` is passed, print formulae #: List all installed formulae. If `--full-name` is passed, print formulae
#: with fully-qualified names. If `--full-name` is not passed, any other #: with fully-qualified names. If `--full-name` is not passed, other
#: options (e.g. `-t`) are passed to `ls` which produces the actual output. #: options (i.e. `-1`, `-l`, `-t` and `-r`) are passed to `ls` which produces the actual output.
#: #:
#: * `list`, `ls` `--unbrewed`: #: * `list`, `ls` `--unbrewed`:
#: List all files in the Homebrew prefix not installed by Homebrew. #: List all files in the Homebrew prefix not installed by Homebrew.
@ -33,6 +33,11 @@ module Homebrew
switch "--full-name" switch "--full-name"
switch "--multiple", depends_on: "--versions" switch "--multiple", depends_on: "--versions"
switch :verbose switch :verbose
# passed through to ls
switch "-1"
switch "-l"
switch "-t"
switch "-r"
end end
# Use of exec means we don't explicitly exit # Use of exec means we don't explicitly exit

View File

@ -302,10 +302,10 @@ With `--verbose` or `-v`, many commands print extra debugging information. Note
If `--force` (or `-f`) is passed, Homebrew will allow keg-only formulae to be linked. If `--force` (or `-f`) is passed, Homebrew will allow keg-only formulae to be linked.
* `list`, `ls` [`--full-name`]: * `list`, `ls` [`--full-name`] [`-1`] [`-l`] [`-t`] [`-r`]:
List all installed formulae. If `--full-name` is passed, print formulae List all installed formulae. If `--full-name` is passed, print formulae
with fully-qualified names. If `--full-name` is not passed, any other with fully-qualified names. If `--full-name` is not passed, other
options (e.g. `-t`) are passed to `ls` which produces the actual output. options (i.e. `-1`, `-l`, `-t` and `-r`) are passed to `ls` which produces the actual output.
* `list`, `ls` `--unbrewed`: * `list`, `ls` `--unbrewed`:
List all files in the Homebrew prefix not installed by Homebrew. List all files in the Homebrew prefix not installed by Homebrew.

View File

@ -311,8 +311,8 @@ If \fB\-\-dry\-run\fR or \fB\-n\fR is passed, Homebrew will list all files which
If \fB\-\-force\fR (or \fB\-f\fR) is passed, Homebrew will allow keg\-only formulae to be linked\. If \fB\-\-force\fR (or \fB\-f\fR) is passed, Homebrew will allow keg\-only formulae to be linked\.
. .
.TP .TP
\fBlist\fR, \fBls\fR [\fB\-\-full\-name\fR] \fBlist\fR, \fBls\fR [\fB\-\-full\-name\fR] [\fB\-1\fR] [\fB\-l\fR] [\fB\-t\fR] [\fB\-r\fR]
List all installed formulae\. If \fB\-\-full\-name\fR is passed, print formulae with fully\-qualified names\. If \fB\-\-full\-name\fR is not passed, any other options (e\.g\. \fB\-t\fR) are passed to \fBls\fR which produces the actual output\. List all installed formulae\. If \fB\-\-full\-name\fR is passed, print formulae with fully\-qualified names\. If \fB\-\-full\-name\fR is not passed, other options (i\.e\. \fB\-1\fR, \fB\-l\fR, \fB\-t\fR and \fB\-r\fR) are passed to \fBls\fR which produces the actual output\.
. .
.TP .TP
\fBlist\fR, \fBls\fR \fB\-\-unbrewed\fR \fBlist\fR, \fBls\fR \fB\-\-unbrewed\fR