Update manpages and auto-completion

doc/man/restic-ls.1

@@ -2,17 +2,14 @@
 .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" ""
 
 .SH NAME
-.PP
 restic-ls - List files in a snapshot
 
 
 .SH SYNOPSIS
-.PP
 \fBrestic ls [flags] snapshotID [dir...]\fP
 
 
 .SH DESCRIPTION
-.PP
 The "ls" command lists files and directories in a snapshot.
 
 .PP
@@ -30,9 +27,13 @@ will allow traversing into matching directories' subfolders.
 Any directory paths specified must be absolute (starting with
 a path separator); paths use the forward slash '/' as separator.
 
+.PP
+File listings can be sorted by specifying --sort followed by one of the
+sort specifiers '(name|size|time=mtime|atime|ctime|extension)'.
+The sorting can be reversed by specifying --reverse.
+
 
 .SH EXIT STATUS
-.PP
 Exit status is 0 if the command was successful.
 Exit status is 1 if there was any error.
 Exit status is 10 if the repository does not exist.
@@ -41,7 +42,6 @@ Exit status is 12 if the password is incorrect.
 
 
 .SH OPTIONS
-.PP
 \fB-h\fP, \fB--help\fP[=false]
 	help for ls
 
@@ -69,13 +69,20 @@ Exit status is 12 if the password is incorrect.
 \fB--recursive\fP[=false]
 	include files in subfolders of the listed directories
 
+.PP
+\fB--reverse\fP[=false]
+	reverse sorted output
+
+.PP
+\fB-s\fP, \fB--sort\fP=name
+	sort output by (name|size|time=mtime|atime|ctime|extension)
+
 .PP
 \fB--tag\fP=[]
 	only consider snapshots including \fBtag[,tag,...]\fR, when snapshot ID "latest" is given (can be specified multiple times)
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
-.PP
 \fB--cacert\fP=[]
 	\fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT)
 
@@ -177,5 +184,4 @@ Exit status is 12 if the password is incorrect.
 
 
 .SH SEE ALSO
-.PP
 \fBrestic(1)\fP