Add new, pandoc-powered man page

This also includes some of the options that I forgot existed. Don't be mad.

contrib/man/exa.1

@@ -1,117 +1,164 @@
-.TH exa "1" "7/Jun/2015" "exa 0.3.0" "User Commands"
+.hy
+.TH "exa" "1" "2015\-10\-18" "exa 0.4.0" ""
 .SH NAME
-exa - a modern replacement for ls
+.PP
+exa \- a modern replacement for ls
 .SH SYNOPSIS
-.B exa
-[\fIOPTIONS\fR] [\fIFILES...\fR]
+.PP
+exa [\f[I]options\f[]] [\f[I]files\f[]]...
 .SH DESCRIPTION
-exa is a modern replacement for ls. 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 ls, such as viewing the Git status for a directory, or
-recursing into directories with a tree view.
-
-.SH OPTIONS
-
-.TP
-\fB\-?\fR, \fB\-\-help\fR
-Show list of command-line options
-.TP
-\fB\-\-VERSION\fR
-Display version of exa
-
-.SH FILTERING OPTIONS
-
-.TP
-\fB\-a\fR, \fB\-\-all\fR
-show dot-files
-.TP
-\fB\-d\fR, \fB\-\-list-dirs\fR
-list directories as regular files
+.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
-\fB\-\-group-directories-first\fR
-list directories before other files
+.B \-G, \-\-grid
+display entries in a grid view (default)
+.RS
+.RE
 .TP
-\fB\-L\fR, \fB\-\-level\fR DEPTH
-maximum depth of recursion
+.B \-l, \-\-long
+display extended details and attributes
+.RS
+.RE
 .TP
-\fB\-R\fR, \fB\-\-recurse\fR
+.B \-R, \-\-recurse
 recurse into directories
-
-.SH VIEW OPTIONS
-
+.RS
+.RE
 .TP
-\fB\-1\fR, \fB\-\-oneline\fR
-display one entry per line
+.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
 .TP
-\fB\-r\fR, \fB\-\-reverse\fR
+.B \-r, \-\-reverse
 reverse order of files
+.RS
+.RE
 .TP
-\fB\-s\fR, \fB\-\-sort\fR WORD
-field to sort by
+.B \-s, \-\-sort=\f[I]WORD\f[]
+field to sort by (name, size, extension, modified, accessed, created,
+inode, none)
+.RS
+.RE
 .TP
-\fB\-x\fR, \fB\-\-across\fR
-sort multi-column view entries across
-.TP
-\fB\-T\fR, \fB\-\-tree\fR
-recurse into subdirectories in a tree view
-
-.SH LONG FORMAT OPTIONS
-
+.B \-\-group\-directories\-first
+list directories before other files
+.RS
+.RE
+.SH LONG VIEW OPTIONS
 .TP
-\fB\-b\fR, \fB\-\-binary\fR
+.B \-b, \-\-binary
 use binary prefixes in file sizes
+.RS
+.RE
 .TP
-\fB\-B\fR, \fB\-\-bytes\fR
+.B \-B, \-\-bytes
 list file sizes in bytes, without prefixes
+.RS
+.RE
 .TP
-\fB\-g\fR, \fB\-\-group\fR
+.B \-g, \-\-group
 show group as well as user
+.RS
+.RE
 .TP
-\fB\-\-git\fR
-show git status
-.TP
-\fB\-h\fR, \fB\-\-header\fR
+.B \-h, \-\-header
 show a header row at the top
+.RS
+.RE
 .TP
-\fB\-H\fR, \fB\-\-links\fR
+.B \-H, \-\-links
 show number of hard links
+.RS
+.RE
 .TP
-\fB\-i\fR, \fB\-\-inode\fR
-show each file's inode number
+.B \-i, \-\-inode
+show each file\[aq]s inode number
+.RS
+.RE
 .TP
-\fB\-l\fR, \fB\-\-long\fR
-display extended details and attributes
+.B \-L, \-\-level=\f[I]DEPTH\f[]
+maximum depth of recursion
+.RS
+.RE
 .TP
-\fB\-m\fR, \fB\-\-modified\fR
+.B \-m, \-\-modified
 display timestamp of most recent modification
+.RS
+.RE
 .TP
-\fB\-S\fR, \fB\-\-blocks\fR
+.B \-S, \-\-blocks
 show number of file system blocks
+.RS
+.RE
 .TP
-\fB\-t\fR, \fB\-\-time\fR WORD
-which timestamp to show for a file
+.B \-t, \-\-time=\f[I]WORD\f[]
+which timestamp to show for a file (modified, accessed, created)
+.RS
+.RE
 .TP
-\fB\-u\fR, \fB\-\-accessed\fR
+.B \-u, \-\-accessed
 display timestamp of last access for a file
+.RS
+.RE
 .TP
-\fB\-U\fR, \fB\-\-created\fR
+.B \-U, \-\-created
 display timestamp of creation for a file
-.TP
-\fB\-@\fR, \fB\-\-extended\fR
-display extended attribute keys and sizes
-
-.SH "EXAMPLES"
-
+.RS
+.RE
+.SH EXAMPLES
+.PP
 To display a list of files, with the largest at the top:
-
-    $ exa --reverse --sort=size
-
+.IP
+.nf
+\f[C]
+exa\ \-\-reverse\ \-\-sort=size
+\f[]
+.fi
+.PP
 To display a tree of files, three levels deep:
-
-    $ exa --long --tree --level=3
-
-.SH "AUTHOR"
-exa is maintained by Benjamin `ogham` Sago and many other contributors. You
-can view the full list at \fIhttps://github.com/ogham/exa/contributors\fR\.
-
+.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>.