Update manpages and auto-completion

doc/man/restic-backup.1

@@ -25,6 +25,10 @@ Exit status is 3 if some source data could not be read (incomplete snapshot crea
 
 
 .SH OPTIONS
+.PP
+\fB\-n\fP, \fB\-\-dry\-run\fP[=false]
+	do not upload or write any data, just show what would be done
+
 .PP
 \fB\-e\fP, \fB\-\-exclude\fP=[]
 	exclude a \fB\fCpattern\fR (can be specified multiple times)
@@ -91,7 +95,7 @@ Exit status is 3 if some source data could not be read (incomplete snapshot crea
 
 .PP
 \fB\-\-parent\fP=""
-	use this parent \fB\fCsnapshot\fR (default: last snapshot in the repo that has the same target files/directories)
+	use this parent \fB\fCsnapshot\fR (default: last snapshot in the repo that has the same target files/directories, and is not newer than the snapshot time)
 
 .PP
 \fB\-\-stdin\fP[=false]
@@ -127,6 +131,10 @@ Exit status is 3 if some source data could not be read (incomplete snapshot crea
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-cache.1

@@ -52,6 +52,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-cat.1

@@ -40,6 +40,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-check.1

@@ -41,7 +41,7 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 
 .PP
 \fB\-\-read\-data\-subset\fP=""
-	read a \fB\fCsubset\fR of data packs, specified as 'n/t' for specific subset or either 'x%' or 'x.y%' for random subset
+	read a \fB\fCsubset\fR of data packs, specified as 'n/t' for specific part, or either 'x%' or 'x.y%' or a size in bytes with suffixes k/K, m/M, g/G, t/T for a random subset
 
 .PP
 \fB\-\-with\-cache\fP[=false]
@@ -61,6 +61,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-copy.1

@@ -81,6 +81,10 @@ new destination repository using the "init" command.
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-diff.1

@@ -60,6 +60,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-dump.1

@@ -63,6 +63,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-find.1

@@ -85,6 +85,10 @@ It can also be used to search for restic blobs or trees for troubleshooting.
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-forget.1

@@ -15,8 +15,9 @@ restic\-forget \- Remove snapshots from the repository
 .PP
 The "forget" command removes snapshots according to a policy. Please note that
 this command really only deletes the snapshot object in the repository, which
-is a reference to data stored there. In order to remove this (now unreferenced)
-data after 'forget' was run successfully, see the 'prune' command.
+is a reference to data stored there. In order to remove the unreferenced data
+after "forget" was run successfully, see the "prune" command. Please also read
+the documentation for "forget" to learn about important security considerations.
 
 
 .SH EXIT STATUS
@@ -135,6 +136,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-generate.1

@@ -57,6 +57,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-init.1

@@ -64,6 +64,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-key.1

@@ -52,6 +52,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-list.1

@@ -40,6 +40,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-ls.1

@@ -43,7 +43,7 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 
 .PP
 \fB\-H\fP, \fB\-\-host\fP=[]
-	only consider snapshots for this \fB\fChost\fR, when no snapshot ID is given (can be specified multiple times)
+	only consider snapshots for this \fB\fChost\fR, when snapshot ID "latest" is given (can be specified multiple times)
 
 .PP
 \fB\-l\fP, \fB\-\-long\fP[=false]
@@ -51,7 +51,7 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 
 .PP
 \fB\-\-path\fP=[]
-	only consider snapshots which include this (absolute) \fB\fCpath\fR, when no snapshot ID is given
+	only consider snapshots which include this (absolute) \fB\fCpath\fR, when snapshot ID "latest" is given (can be specified multiple times)
 
 .PP
 \fB\-\-recursive\fP[=false]
@@ -59,7 +59,7 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 
 .PP
 \fB\-\-tag\fP=[]
-	only consider snapshots which include this \fB\fCtaglist\fR, when no snapshot ID is given
+	only consider snapshots which include this \fB\fCtaglist\fR, when snapshot ID "latest" is given (can be specified multiple times)
 
 
 .SH OPTIONS INHERITED FROM PARENT COMMANDS
@@ -75,6 +75,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-migrate.1

@@ -45,6 +45,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-mount.1

@@ -100,6 +100,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-prune.1

@@ -57,6 +57,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-rebuild-index.1

@@ -45,6 +45,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-recover.1

@@ -3,7 +3,7 @@
 
 .SH NAME
 .PP
-restic\-recover \- Recover data from the repository
+restic\-recover \- Recover data from the repository not referenced by snapshots
 
 
 .SH SYNOPSIS
@@ -14,8 +14,8 @@ restic\-recover \- Recover data from the repository
 .SH DESCRIPTION
 .PP
 The "recover" command builds a new snapshot from all directories it can find in
-the raw data of the repository. It can be used if, for example, a snapshot has
-been removed by accident with "forget".
+the raw data of the repository which are not referenced in an existing snapshot.
+It can be used if, for example, a snapshot has been removed by accident with "forget".
 
 
 .SH EXIT STATUS
@@ -42,6 +42,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-restore.1

@@ -81,6 +81,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-self-update.1

@@ -47,6 +47,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-snapshots.1

@@ -64,6 +64,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-stats.1

@@ -86,6 +86,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-tag.1

@@ -71,6 +71,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-unlock.1

@@ -44,6 +44,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic-version.1

@@ -41,6 +41,10 @@ Exit status is 0 if the command was successful, and non\-zero if there was any e
 \fB\-\-cleanup\-cache\fP[=false]
 	auto remove old cache directories
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it

doc/man/restic.1

@@ -34,6 +34,10 @@ directories in an encrypted repository stored on different backends.
 \fB\-h\fP, \fB\-\-help\fP[=false]
 	help for restic
 
+.PP
+\fB\-\-insecure\-tls\fP[=false]
+	skip TLS certificate verification when connecting to the repo (insecure)
+
 .PP
 \fB\-\-json\fP[=false]
 	set output mode to JSON for commands that support it