mirror of
https://github.com/Llewellynvdm/exa.git
synced 2024-11-18 10:15:10 +00:00
57c647fee5
This was touched on in #209 where I got the docs wrong compared to the actual implementation, but after thinking about it, I’d like to switch it round. (The --sort=Name and --sort=name difference has also been switched.) See the big ol’ comment for my reasons. Because this changes core functionality, it broke many, many tests. You can see that this doesn’t change the -star- tests because the shell, rather than exa, orders the globbed files. I kept on forgetting which way round Sensitive and Insensitive went, so I named them after the effect they have.
196 lines
3.6 KiB
Groff
196 lines
3.6 KiB
Groff
.hy
|
|
.TH "exa" "1" "2017\-07\-07" "exa 0.7.0" ""
|
|
.SH NAME
|
|
.PP
|
|
exa \- a modern replacement for ls
|
|
.SH SYNOPSIS
|
|
.PP
|
|
exa [\f[I]options\f[]] [\f[I]files\f[]]...
|
|
.SH DESCRIPTION
|
|
.PP
|
|
\f[C]exa\f[] is a modern replacement for \f[C]ls\f[].
|
|
It uses colours for information by default, helping you distinguish
|
|
between many types of files, such as whether you are the owner, or in
|
|
the owning group.
|
|
It also has extra features not present in the original \f[C]ls\f[], such
|
|
as viewing the Git status for a directory, or recursing into directories
|
|
with a tree view.
|
|
.SH DISPLAY OPTIONS
|
|
.TP
|
|
.B \-1, \-\-oneline
|
|
display one entry per line
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-G, \-\-grid
|
|
display entries as a grid (default)
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-l, \-\-long
|
|
display extended file metadata as a table
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-x, \-\-across
|
|
sort the grid across, rather than downwards
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-R, \-\-recurse
|
|
recurse into directories
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-T, \-\-tree
|
|
recurse into directories as a tree
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\-color, \-\-colour=\f[I]WHEN\f[]
|
|
when to use terminal colours (always, automatic, never)
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\-color-scale, \-\-colour-scale
|
|
highlight levels of file sizes distinctly
|
|
.RS
|
|
.RE
|
|
.SH FILTERING AND SORTING OPTIONS
|
|
.TP
|
|
.B \-a, \-\-all
|
|
show hidden and \[aq]dot\[aq] files.
|
|
Use this twice to also show the \f[C].\f[] and \f[C]..\f[] directories.
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-d, \-\-list\-dirs
|
|
list directories like regular files
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-r, \-\-reverse
|
|
reverse the sort order
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-s, \-\-sort=\f[I]SORT_FIELD\f[]
|
|
which field to sort by.
|
|
Valid fields are name, Name, extension, Extension, size, modified, accessed, created, inode, type, and none.
|
|
Fields starting with a capital letter will sort uppercase before lowercase: 'A' then 'B' then 'a' then 'b'.
|
|
Fields starting with a lowercase letter will mix them: 'A' then 'a' then 'B' then 'b'.
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-I, \-\-ignore\-glob=\f[I]GLOBS\f[]
|
|
Glob patterns, pipe-separated, of files to ignore
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\-group\-directories\-first
|
|
list directories before other files
|
|
.RS
|
|
.RE
|
|
.SH LONG VIEW OPTIONS
|
|
.PP
|
|
These options are available when running with \f[C]\-\-long\f[]
|
|
(\f[C]\-l\f[]):
|
|
.TP
|
|
.B \-b, \-\-binary
|
|
list file sizes with binary prefixes
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-B, \-\-bytes
|
|
list file sizes in bytes, without any prefixes
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-g, \-\-group
|
|
list each file\[aq]s group
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-h, \-\-header
|
|
add a header row to each column
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-H, \-\-links
|
|
list each file\[aq]s number of hard links
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-i, \-\-inode
|
|
list each file\[aq]s inode number
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-L, \-\-level=\f[I]DEPTH\f[]
|
|
limit the depth of recursion
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-m, \-\-modified
|
|
use the modified timestamp field
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-S, \-\-blocks
|
|
list each file\[aq]s number of file system blocks
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-t, \-\-time=\f[I]WORD\f[]
|
|
which timestamp field to list (modified, accessed, created)
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\-time\-style=\f[I]STYLE\f[]
|
|
how to format timestamps (default, iso, long-iso, full-iso)
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-u, \-\-accessed
|
|
use the accessed timestamp field
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-U, \-\-created
|
|
use the created timestamp field
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\@, \-\-extended
|
|
list each file\[aq]s extended attributes and sizes
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \-\-git
|
|
list each file\[aq]s Git status, if tracked
|
|
.RS
|
|
.RE
|
|
.SH EXAMPLES
|
|
.PP
|
|
To display a list of files, with the largest at the top:
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
exa\ \-\-reverse\ \-\-sort=size
|
|
\f[]
|
|
.fi
|
|
.PP
|
|
To display a tree of files, three levels deep:
|
|
.IP
|
|
.nf
|
|
\f[C]
|
|
exa\ \-\-long\ \-\-tree\ \-\-level=3
|
|
\f[]
|
|
.fi
|
|
.SH AUTHOR
|
|
.PP
|
|
\f[C]exa\f[] is maintained by Benjamin \[aq]ogham\[aq] Sago and many
|
|
other contributors.
|
|
You can view the full list at
|
|
<https://github.com/ogham/exa/graphs/contributors>.
|