mirror of
https://github.com/Llewellynvdm/exa.git
synced 2024-11-11 15:20:58 +00:00
c475cccce4
I changed my mind about which way round sorting by “newest” or by “oldest” should actually go. If you’re listing a large directory, you see the last lines of the output first, so these files should be the ones with the largest whatever the sort field is. It’s about sorting *last*, not sorting *first*. Sorting by size wouldn’t say “sorts smallest files first”, it would say “sorts largest files last”. Right? Also, add a new suggestion that warns against “ls -lt”.
197 lines
3.7 KiB
Groff
197 lines
3.7 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.
|
|
The modified field has the aliases date, time, and newest, and its reverse order has the aliases age and oldest.
|
|
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>.
|