man, shell completion: add --dry-run-metadata

These changes were made automatically via scripts.

misc/bash_completion.d/tarsnap

@@ -52,13 +52,13 @@ _tarsnap ()
 	longopts="--aggressive-networking --archive-names --cachedir \
 		  --check-links --checkpoint-bytes --chroot --configfile \
 		  --creationtime --csv-file --disk-pause --dry-run \
-		  --dump-config --exclude --fast-read --force-resources \
-		  --fsck --fsck-prune --hashes --humanize-numbers \
-		  --include --initialize-cachedir --insane-filesystems \
-		  --iso-dates --keep-going --keep-newer-files --keyfile \
-		  --list-archives --lowmem --maxbw --maxbw-rate \
-		  --maxbw-rate-down --maxbw-rate-up --newer \
-		  --newer-mtime --newer-than --newer-mtime-than \
+		  --dry-run-metadata --dump-config --exclude --fast-read \
+		  --force-resources --fsck --fsck-prune --hashes \
+		  --humanize-numbers --include --initialize-cachedir \
+		  --insane-filesystems --iso-dates --keep-going \
+		  --keep-newer-files --keyfile --list-archives --lowmem \
+		  --maxbw --maxbw-rate --maxbw-rate-down --maxbw-rate-up \
+		  --newer --newer-mtime --newer-than --newer-mtime-than \
 		  --no-aggressive-networking --no-config-exclude \
 		  --no-config-include --no-default-config \
 		  --no-disk-pause --no-force-resources \

misc/zsh_completion/_tarsnap

@@ -527,6 +527,7 @@ _shtab_tarsnap_c_options=(
   "--creationtime[manually specify a creation time for the archive]:X:"
   "--disk-pause[often pause for ARG ms while creating an archive]:X:"
   "--dry-run[do not really create an archive\; just simulate doing so]"
+  "--dry-run-metadata[do not really create an archive\; just simulate the metadata]"
   "--exclude[do not process certain files or directories]:pattern:"
   "-f[specify name of archive to operate on]:archive-name:(${archive_list}):"
   "-H[store the targets of a symbolic links]"

tar/tarsnap.1-man.in

@@ -354,6 +354,26 @@ Furthermore,
 \fB\--dry-run\fP
 will not check whether the cache directory is out of sync.
 .TP
+\fB\--dry-run-metadata\fP
+(c mode only)
+Don't really create an archive; just simulate doing so.
+This is similar to
+\fB\--dry-run\fP,
+except that it doesn't read any files; it only processes filesystem metadata.
+.PP
+This is significantly faster than a regular
+\fB\--dry-run\fP,
+but it is still suitable for checking which filesystem entries will be
+archived (with
+\fB\-v\fP),
+or getting the total uncompressed archive size (via
+\fB\--totals\fP
+or
+\fB\--progress-bytes\fP).
+.PP
+This option cannot be used with
+\fB\--print-stats\fP.
+.TP
 \fB\--dump-config\fP
 Print out the command-line and all non-blank lines read from config files.
 .TP