exa/contrib/man/exa.1

178 lines
2.9 KiB
Groff
Raw Normal View History

.hy
.TH "exa" "1" "2015\-10\-18" "exa 0.4.0" ""
2015-06-07 15:45:58 +00:00
.SH NAME
.PP
exa \- a modern replacement for ls
2015-06-07 15:45:58 +00:00
.SH SYNOPSIS
.PP
exa [\f[I]options\f[]] [\f[I]files\f[]]...
2015-06-07 15:45:58 +00:00
.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
2015-06-07 15:45:58 +00:00
.TP
.B \-G, \-\-grid
display entries in a grid view (default)
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-l, \-\-long
display extended details and attributes
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-R, \-\-recurse
2015-06-07 15:45:58 +00:00
recurse into directories
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-T, \-\-tree
recurse into subdirectories in a tree view
.RS
.RE
.TP
.B \-x, \-\-across
sort multi\-column view entries across
.RS
.RE
.TP
.B \-\-color, \-\-colour=\f[I]WHEN\f[]
when to colourise the output (always, automatic, never)
.RS
.RE
.SH FILTERING AND SORTING OPTIONS
.TP
.B \-a, \-\-all
show dot\-files
.RS
.RE
.TP
.B \-d, \-\-list\-dirs
list directories as regular files
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-r, \-\-reverse
2015-06-07 15:45:58 +00:00
reverse order of files
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-s, \-\-sort=\f[I]WORD\f[]
field to sort by (name, size, extension, modified, accessed, created,
inode, none)
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-\-group\-directories\-first
list directories before other files
.RS
.RE
.SH LONG VIEW OPTIONS
2015-11-19 13:21:31 +00:00
.PP
These options are available when running with \f[C]\-\-long\f[]
(\f[C]\-l\f[]):
2015-06-07 15:45:58 +00:00
.TP
.B \-b, \-\-binary
2015-06-07 15:45:58 +00:00
use binary prefixes in file sizes
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-B, \-\-bytes
2015-06-07 15:45:58 +00:00
list file sizes in bytes, without prefixes
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-g, \-\-group
2015-06-07 15:45:58 +00:00
show group as well as user
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-h, \-\-header
2015-06-07 15:45:58 +00:00
show a header row at the top
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-H, \-\-links
2015-06-07 15:45:58 +00:00
show number of hard links
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-i, \-\-inode
show each file\[aq]s inode number
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-L, \-\-level=\f[I]DEPTH\f[]
maximum depth of recursion
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-m, \-\-modified
2015-06-07 15:45:58 +00:00
display timestamp of most recent modification
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-S, \-\-blocks
2015-06-07 15:45:58 +00:00
show number of file system blocks
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-t, \-\-time=\f[I]WORD\f[]
which timestamp to show for a file (modified, accessed, created)
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-u, \-\-accessed
2015-06-07 15:45:58 +00:00
display timestamp of last access for a file
.RS
.RE
2015-06-07 15:45:58 +00:00
.TP
.B \-U, \-\-created
2015-06-07 15:45:58 +00:00
display timestamp of creation for a file
.RS
.RE
2015-11-19 13:21:31 +00:00
.TP
.B \-\@, \-\-extended
display extended attribute keys and sizes
.RS
.RE
.TP
.B \-\-git
display Git status for a file, if available
.RS
.RE
.SH EXAMPLES
.PP
2015-06-07 15:45:58 +00:00
To display a list of files, with the largest at the top:
.IP
.nf
\f[C]
exa\ \-\-reverse\ \-\-sort=size
\f[]
.fi
.PP
2015-06-07 15:45:58 +00:00
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>.