For lack of a better source of gtar.1, regenerate said using help2man, as

the previous one was seriously outdated. Provide a helpful target for the
future. Bump PKGREVISION.

2 files changed, 554 insertions, 197 deletions

diff --git a/archivers/gtar-base/Makefile b/archivers/gtar-base/Makefile
index 336dd1e37f2..c6e560f4e02 100644
--- a/archivers/gtar-base/Makefile
+++ b/archivers/gtar-base/Makefile
@@ -1,7 +1,11 @@
-# $NetBSD: Makefile,v 1.80 2014/02/24 08:16:56 adam Exp $
+# $NetBSD: Makefile,v 1.81 2014/03/12 13:32:14 fhajny Exp $
+#
+# Please run 'make files/gtar.1' when updating version of this package
+# to regenerate the man page. converters/help2man is needed.
 
 DISTNAME=	tar-1.27.1
 PKGNAME=	${DISTNAME:S/tar/gtar-base/}
+PKGREVISION=	1
 SVR4_PKGNAME=	gtarb
 CATEGORIES=	archivers
 MASTER_SITES=	${MASTER_SITE_GNU:=tar/}
@@ -55,6 +59,13 @@ SYMLINKS=		bin/gtar ${PKGGNUDIR}bin/tar \
 SYMLINKS+=		libexec/grmt ${PKGGNUDIR}libexec/rmt
 .endif
 
+files/gtar.1: build
+	${ECHO} .\\\" > ${FILESDIR}/gtar.1
+	${ECHO} .\\\" \$$NetBSD\$$ >> ${FILESDIR}/gtar.1
+	help2man --name "The GNU version of the tar archiving utility" \
+		--info-page tar ${WRKSRC}/src/tar | \
+		${SED} '/help2man/d' >> ${FILESDIR}/gtar.1
+
 post-install:
 	${INSTALL_MAN} ${FILESDIR}/gtar.1 \
 		${DESTDIR}${PREFIX}/${PKGMANDIR}/man1/gtar.1
diff --git a/archivers/gtar-base/files/gtar.1 b/archivers/gtar-base/files/gtar.1
index 18736655852..1ecce96a481 100644
--- a/archivers/gtar-base/files/gtar.1
+++ b/archivers/gtar-base/files/gtar.1
@@ -1,265 +1,611 @@
 .\"
-.\" $NetBSD: gtar.1,v 1.4 2004/09/27 16:12:04 wiz Exp $
-.\" @(#)tar.1 1.13.25 2000/12/14 Werner;
-.\" from SuSe tar-1.13.25-45.src.rpm
-.TH TAR 1 "14 December 2000" "Version 1.13.25"
-.UC 1
+.\" $NetBSD: gtar.1,v 1.5 2014/03/12 13:32:14 fhajny Exp $
+.TH TAR "1" "March 2014" "tar 1.27.1" "User Commands"
 .SH NAME
 tar \- The GNU version of the tar archiving utility
 .SH SYNOPSIS
 .B tar
-.RB [ \- ]
-.RB [ "A \-\-catenate \-\-concatenate" \||\| "c \-\-create" \||\| "d \-\-diff \-\-compare" \||\| "r \-\-append" \||\| "t \-\-list" \||\| "u \-\-update" \||\| "x \-\-extract \-\-get" ]
-.RB [ \-\-atime\-preserve ]
-.RB [ "\-b, \-\-block\-size=\fIN\fP" ]
-.RB [ "\-B, \-\-read\-full\-blocks" ]
-.RB [ "\-C, \-\-directory=\fIDIR\fP" ]
-.RB [ \-\-checkpoint ]
-.RB [ "\-f, \-\-file=\fR[\fP\fIHOSTNAME\fP:\fR]\fP\fIF\fP" ]
-.RB [ "\-F, \-\-info\-script=\fIF\fP, \-\-new\-volume\-script=\fIF\fP" ]
-.RB [ "\-\-force\-local" ]
-.RB [ "\-G, \-\-incremental" ]
-.RB [ "\-g, \-\-listed\-incremental=\fIF\fP" ]
-.RB [ "\-h, \-\-dereference" ]
-.RB [ "\-i, \-\-ignore\-zeros" ]
-.RB [ "\-j, \-\-bzip2, \-\-bunzip2" ]
-.RB [ \-\-ignore\-failed\-read ]
-.RB [ "\-k, \-\-keep\-old\-files" ]
-.RB [ "\-K, \-\-starting\-file=\fIF\fP" ]
-.RB [ "\-l, \-\-one\-file\-system" ]
-.RB [ "\-L, \-\-tape\-length=\fIN\fP" ]
-.RB [ "\-m, \-\-modification\-time" ]
-.RB [ "\-M, \-\-multi\-volume" ]
-.RB [ "\-N, \-\-after\-date=\fIDATE\fP, \-\-newer=\fIDATE\fP" ]
-.RB [ "\-o, \-\-old\-archive, \-\-portability" ]
-.RB [ "\-O, \-\-to\-stdout" ]
-.RB [ "\-p, \-\-same\-permissions, \-\-preserve\-permissions" ]
-.RB [ "\-P, \-\-absolute\-paths" ]
-.RB [ \-\-preserve ]
-.RB [ "\-R, \-\-record\-number" ]
-.RB [ "\-\-recursive\-unlink" ]
-.RB [ \-\-remove\-files ]
-.RB [ "\-s, \-\-same\-order, \-\-preserve\-order" ]
-.RB [ \-\-same\-owner ]
-.RB [ "\-S, \-\-sparse" ]
-.RB [ "\-T, \-\-files\-from=\fIF\fP" ]
-.RB [ \-\-null ]
-.RB [ \-\-totals ]
-.RB [ "\-v, \-\-verbose" ]
-.RB [ "\-V, \-\-label=\fINAME\fP" ]
-.RB [ \-\-version ]
-.RB [ "\-w, \-\-interactive, \-\-confirmation" ]
-.RB [ "\-W, \-\-verify" ]
-.RB [ "\-\-exclude=\fIFILE\fP" ]
-.RB [ "\-X, \-\-exclude\-from=\fIFILE\fP" ]
-.RB [ "\-Z, \-\-compress, \-\-uncompress" ]
-.RB [ "\-z, \-\-gzip, \-\-ungzip" ]
-.RB [ "\-\-use\-compress\-program=\fIPROG\fP" ]
-.RB [ \-\-block\-compress ]
-.RB [ \-\fR[\fP0\-7\fR][\fPlmh\fR]\fP ]
-.TP
-.I filename1 \fR[\fP filename2\fR,\fP \fR...\fP filenameN \fR]
-.TP
-.I directory1 \fR[\fP directory2\fR,\fP \fR...\fP directoryN \fR]
+[\fIOPTION\fR...] [\fIFILE\fR]...
 .SH DESCRIPTION
-.LP
-This manual page documents the GNU version 1.13.25 of
-.BR tar ,
-an archiving program designed to store and extract files from
-an archive file known as a
-.IR tarfile .
-A
-.I tarfile
-may be made on a tape drive, however, it is also common
-to write a
-.I tarfile
-to a normal file.
-The first argument to
-.B tar
-must be one of the options:
-.BR Acdrtux ,
-followed by any optional functions.
-The final arguments to
-.B tar
-are the names of the files or directories which should be archived. The use
-of a directory name always implies that the subdirectories below should be
-included in the archive.
-.SH "FUNCTION LETTERS"
+GNU 'tar' saves many files together into a single tape or disk archive, and can
+restore individual files from the archive.
+.SH EXAMPLES
+.TP
+tar \-cf archive.tar foo bar
+# Create archive.tar from files foo and bar.
+.TP
+tar \-tvf archive.tar
+# List all files in archive.tar verbosely.
 .TP
-.B One of the following options must be used:
+tar \-xf archive.tar
+# Extract all files from archive.tar.
+.IP
+Main operation mode:
 .TP
-.B \-A, \-\-catenate, \-\-concatenate
+\-A, \-\-catenate, \-\-concatenate
 append tar files to an archive
 .TP
-.B \-c, \-\-create
+\-c, \-\-create
 create a new archive
 .TP
-.B \-d, \-\-diff, \-\-compare
+\-d, \-\-diff, \-\-compare
 find differences between archive and file system
 .TP
-.B \-\-delete
-delete from the archive (not for use on mag tapes!)
+\-\-delete
+delete from the archive (not on mag tapes!)
 .TP
-.B \-r, \-\-append
+\-r, \-\-append
 append files to the end of an archive
 .TP
-.B \-t, \-\-list
+\-t, \-\-list
 list the contents of an archive
 .TP
-.B \-u, \-\-update
-only append files that are newer than copy in archive
+\-\-test\-label
+test the archive volume label and exit
 .TP
-.B \-x, \-\-extract, \-\-get
+\-u, \-\-update
+only append files newer than copy in archive
+.TP
+\-x, \-\-extract, \-\-get
 extract files from an archive
-.SH "OTHER OPTIONS"
+.IP
+Operation modifiers:
 .TP
-.B \-\-atime\-preserve
-don't change access times on dumped files
+\-\-check\-device
+check device numbers when creating incremental
+archives (default)
 .TP
-.B \-b, \-\-block\-size=\fIN
-block size of \fIN\fPx512 bytes (default \fIN\fP=20)
+\-g, \-\-listed\-incremental=FILE
+handle new GNU\-format incremental backup
 .TP
-.B \-B, \-\-read\-full\-blocks
-reblock as we read (for reading 4.2BSD pipes)
+\-G, \-\-incremental
+handle old GNU\-format incremental backup
 .TP
-.B \-C, \-\-directory=\fIDIR
-change to directory \fIDIR
+\-\-ignore\-failed\-read
+do not exit with nonzero on unreadable files
 .TP
-.B \-\-checkpoint
-print directory names while reading the archive
+\-\-level=NUMBER
+dump level for created listed\-incremental archive
 .TP
-.B \-f, \-\-file=\fR[\fP\fIHOSTNAME\fP:\fR]\fP\fIF
-use archive file or device \fIF\fP (default /dev/rmt0)
+\-n, \-\-seek
+archive is seekable
 .TP
-.B \-\-force\-local
-archive file is local even if has a colon
+\-\-no\-check\-device
+do not check device numbers when creating
+incremental archives
 .TP
-.B \-F, \-\-info\-script=\fIF\fP, \-\-new\-volume\-script=\fIF
-run script at end of each tape (implies \-M)
+\-\-no\-seek
+archive is not seekable
 .TP
-.B \-G, \-\-incremental
-create/list/extract old GNU\-format incremental backup
+\-\-occurrence[=NUMBER]
+process only the NUMBERth occurrence of each file
+in the archive; this option is valid only in
+conjunction with one of the subcommands \-\-delete,
+\-\-diff, \-\-extract or \-\-list and when a list of
+files is given either on the command line or via
+the \-T option; NUMBER defaults to 1
 .TP
-.B \-g, \-\-listed\-incremental=\fIF
-create/list/extract new GNU\-format incremental backup
+\-\-sparse\-version=MAJOR[.MINOR]
+set version of the sparse format to use (implies
+\-\-sparse)
 .TP
-.B \-h, \-\-dereference
-don't dump symlinks; dump the files they point to
+\-S, \-\-sparse
+handle sparse files efficiently
+.IP
+Overwrite control:
 .TP
-.B \-i, \-\-ignore\-zeros
-ignore blocks of zeros in archive (normally mean EOF)
+\-k, \-\-keep\-old\-files
+don't replace existing files when extracting,
+treat them as errors
 .TP
-.B \-j, \-\-bzip2, \-\-bunzip2
-filter the archive through bzip2
+\-\-keep\-directory\-symlink
+preserve existing symlinks to directories when
+extracting
 .TP
-.B \-\-ignore\-failed\-read
-don't exit with non\-zero status on unreadable files
+\-\-keep\-newer\-files
+don't replace existing files that are newer than
+their archive copies
 .TP
-.B \-k, \-\-keep\-old\-files
-keep existing files; don't overwrite them from archive
+\-\-no\-overwrite\-dir
+preserve metadata of existing directories
 .TP
-.B \-K, \-\-starting\-file=\fIF
-begin at file F in the archive
+\-\-overwrite
+overwrite existing files when extracting
 .TP
-.B \-l, \-\-one\-file\-system
-stay in local file system when creating an archive
+\-\-overwrite\-dir
+overwrite metadata of existing directories when
+extracting (default)
+.TP
+\-\-recursive\-unlink
+empty hierarchies prior to extracting directory
+.TP
+\-\-remove\-files
+remove files after adding them to the archive
+.TP
+\-\-skip\-old\-files
+don't replace existing files when extracting,
+silently skip over them
+.TP
+\-U, \-\-unlink\-first
+remove each file prior to extracting over it
+.TP
+\-W, \-\-verify
+attempt to verify the archive after writing it
+.IP
+Select output stream:
+.HP
+\-\-ignore\-command\-error ignore exit codes of children
 .TP
-.B \-L, \-\-tape\-length=\fIN
-change tapes after writing N*1024 bytes
+\-\-no\-ignore\-command\-error
+treat non\-zero exit codes of children as
+error
 .TP
-.B \-m, \-\-modification\-time
+\-O, \-\-to\-stdout
+extract files to standard output
+.TP
+\-\-to\-command=COMMAND
+pipe extracted files to another program
+.IP
+Handling of file attributes:
+.TP
+\-\-atime\-preserve[=METHOD]
+preserve access times on dumped files, either
+by restoring the times after reading
+(METHOD='replace'; default) or by not setting the
+times in the first place (METHOD='system')
+.TP
+\-\-delay\-directory\-restore
+delay setting modification times and
+permissions of extracted directories until the end
+of extraction
+.TP
+\-\-group=NAME
+force NAME as group for added files
+.TP
+\-\-mode=CHANGES
+force (symbolic) mode CHANGES for added files
+.TP
+\-\-mtime=DATE\-OR\-FILE
+set mtime for added files from DATE\-OR\-FILE
+.TP
+\-m, \-\-touch
 don't extract file modified time
 .TP
-.B \-M, \-\-multi\-volume
+\-\-no\-delay\-directory\-restore
+cancel the effect of \-\-delay\-directory\-restore
+option
+.TP
+\-\-no\-same\-owner
+extract files as yourself (default for ordinary
+users)
+.TP
+\-\-no\-same\-permissions
+apply the user's umask when extracting permissions
+from the archive (default for ordinary users)
+.TP
+\-\-numeric\-owner
+always use numbers for user/group names
+.TP
+\-\-owner=NAME
+force NAME as owner for added files
+.TP
+\-p, \-\-preserve\-permissions, \-\-same\-permissions
+extract information about file permissions
+(default for superuser)
+.TP
+\-\-preserve
+same as both \-p and \-s
+.TP
+\-\-same\-owner
+try extracting files with the same ownership as
+exists in the archive (default for superuser)
+.TP
+\-s, \-\-preserve\-order, \-\-same\-order
+member arguments are listed in the same order as
+the files in the archive
+.IP
+Handling of extended file attributes:
+.TP
+\-\-acls
+Enable the POSIX ACLs support
+.TP
+\-\-no\-acls
+Disable the POSIX ACLs support
+.TP
+\-\-no\-selinux
+Disable the SELinux context support
+.TP
+\-\-no\-xattrs
+Disable extended attributes support
+.TP
+\-\-selinux
+Enable the SELinux context support
+.TP
+\-\-xattrs
+Enable extended attributes support
+.TP
+\-\-xattrs\-exclude=MASK
+specify the exclude pattern for xattr keys
+.TP
+\-\-xattrs\-include=MASK
+specify the include pattern for xattr keys
+.IP
+Device selection and switching:
+.TP
+\-f, \-\-file=ARCHIVE
+use archive file or device ARCHIVE
+.TP
+\-\-force\-local
+archive file is local even if it has a colon
+.TP
+\-F, \-\-info\-script=NAME, \-\-new\-volume\-script=NAME
+run script at end of each tape (implies \-M)
+.TP
+\-L, \-\-tape\-length=NUMBER
+change tape after writing NUMBER x 1024 bytes
+.TP
+\-M, \-\-multi\-volume
 create/list/extract multi\-volume archive
 .TP
-.B \-N, \-\-after\-date=\fIDATE\fP, \-\-newer=\fIDATE
-only store files newer than \fIDATE
+\-\-rmt\-command=COMMAND
+use given rmt COMMAND instead of rmt
 .TP
-.B \-o, \-\-old\-archive, \-\-portability
-write a V7 format archive, rather than ANSI format
+\-\-rsh\-command=COMMAND
+use remote COMMAND instead of rsh
 .TP
-.B \-O, \-\-to\-stdout
-extract files to standard output
+\-\-volno\-file=FILE
+use/update the volume number in FILE
+.IP
+Device blocking:
 .TP
-.B \-p, \-\-same\-permissions, \-\-preserve\-permissions
-extract all protection information
+\-b, \-\-blocking\-factor=BLOCKS
+BLOCKS x 512 bytes per record
 .TP
-.B \-P, \-\-absolute\-paths
-don't strip leading `/'s from file names
+\-B, \-\-read\-full\-records
+reblock as we read (for 4.2BSD pipes)
 .TP
-.B \-\-preserve
-like \-p \-s
+\-i, \-\-ignore\-zeros
+ignore zeroed blocks in archive (means EOF)
 .TP
-.B \-R, \-\-record\-number
-show record number within archive with each message
+\-\-record\-size=NUMBER
+NUMBER of bytes per record, multiple of 512
+.IP
+Archive format selection:
 .TP
-.B \-\-recursive\-unlink
-Empty hierarchies prior to extracting directory
+\-H, \-\-format=FORMAT
+create archive of the given format
+.IP
+FORMAT is one of the following:
 .TP
-.B \-\-remove\-files
-remove files after adding them to the archive
+gnu
+GNU tar 1.13.x format
 .TP
-.B \-s, \-\-same\-order, \-\-preserve\-order
-list of names to extract is sorted to match archive
+oldgnu
+GNU format as per tar <= 1.12
 .TP
-.B \-\-same\-owner
-create extracted files with the same ownership
+pax
+POSIX 1003.1\-2001 (pax) format
 .TP
-.B \-S, \-\-sparse
-handle sparse files efficiently
+posix
+same as pax
 .TP
-.B \-T, \-\-files\-from=\fIF
-get names to extract or create from file \fIF
+ustar
+POSIX 1003.1\-1988 (ustar) format
 .TP
-.B \-\-null
--T reads null\-terminated names, disable \-C
+v7
+old V7 tar format
 .TP
-.B \-\-totals
-print total bytes written with \-\-create
+\-\-old\-archive, \-\-portability
+same as \-\-format=v7
 .TP
-.B \-v, \-\-verbose
-verbosely list files processed
+\-\-pax\-option=keyword[[:]=value][,keyword[[:]=value]]...
+control pax keywords
 .TP
-.B \-V, \-\-label=\fINAME
-create archive with volume name \fINAME
+\-\-posix
+same as \-\-format=posix
 .TP
-.B \-\-version
-print tar program version number
+\-V, \-\-label=TEXT
+create archive with volume name TEXT; at
+list/extract time, use TEXT as a globbing pattern
+for volume name
+.IP
+Compression options:
 .TP
-.B \-w, \-\-interactive, \-\-confirmation
-ask for confirmation for every action
+\-a, \-\-auto\-compress
+use archive suffix to determine the compression
+program
 .TP
-.B \-W, \-\-verify
-attempt to verify the archive after writing it
+\-I, \-\-use\-compress\-program=PROG
+filter through PROG (must accept \-d)
+.TP
+\-j, \-\-bzip2
+filter the archive through bzip2
 .TP
-.B \-\-exclude=\fIFILE
-exclude file \fIFILE
+\-J, \-\-xz
+filter the archive through xz
 .TP
-.B \-X, \-\-exclude\-from=\fIFILE
-exclude files listed in \fIFILE
+\-\-lzip
+filter the archive through lzip
 .TP
-.B \-Z, \-\-compress, \-\-uncompress      
-filter the archive through compress
+\-\-lzma
+filter the archive through lzma
+.HP
+\-\-lzop
 .TP
-.B \-z, \-\-gzip, \-\-ungzip
+\-\-no\-auto\-compress
+do not use archive suffix to determine the
+compression program
+.TP
+\-z, \-\-gzip, \-\-gunzip, \-\-ungzip
 filter the archive through gzip
 .TP
-.B \-\-use\-compress\-program=\fIPROG
-filter the archive through \fIPROG\fP (which must accept \-d)
-.TP
-.B \-\-block\-compress
-block the output of compression program for tapes
-.TP
-.B \-\fR[\fP0\-7\fR][\fPlmh\fR]
-specify drive and density
-.SH BUGS
-.LP
-The GNU folks, in general, abhor man pages, and create info documents instead.
-The maintainer of tar falls into this category.  This man page is neither
-complete, nor current, and was included in the Debian Linux packaging of tar
-entirely to reduce the frequency with which the lack of a man page gets
-reported as a bug in our defect tracking system.
-
-If you really want to understand tar, then you should run info and read the
-tar info pages, or use the info mode in emacs.
+\-Z, \-\-compress, \-\-uncompress
+filter the archive through compress
+.IP
+Local file selection:
+.TP
+\-\-add\-file=FILE
+add given FILE to the archive (useful if its name
+starts with a dash)
+.TP
+\-\-backup[=CONTROL]
+backup before removal, choose version CONTROL
+.TP
+\-C, \-\-directory=DIR
+change to directory DIR
+.TP
+\-\-exclude=PATTERN
+exclude files, given as a PATTERN
+.TP
+\-\-exclude\-backups
+exclude backup and lock files
+.TP
+\-\-exclude\-caches
+exclude contents of directories containing
+CACHEDIR.TAG, except for the tag file itself
+.TP
+\-\-exclude\-caches\-all
+exclude directories containing CACHEDIR.TAG
+.TP
+\-\-exclude\-caches\-under exclude everything under directories containing
+CACHEDIR.TAG
+.TP
+\-\-exclude\-tag=FILE
+exclude contents of directories containing FILE,
+except for FILE itself
+.HP
+\-\-exclude\-tag\-all=FILE exclude directories containing FILE
+.TP
+\-\-exclude\-tag\-under=FILE
+exclude everything under directories
+containing FILE
+.TP
+\-\-exclude\-vcs
+exclude version control system directories
+.TP
+\-h, \-\-dereference
+follow symlinks; archive and dump the files they
+point to
+.TP
+\-\-hard\-dereference
+follow hard links; archive and dump the files they
+refer to
+.TP
+\-K, \-\-starting\-file=MEMBER\-NAME
+begin at member MEMBER\-NAME when reading the
+archive
+.TP
+\-\-newer\-mtime=DATE
+compare date and time when data changed only
+.TP
+\-\-no\-null
+disable the effect of the previous \-\-null option
+.TP
+\-\-no\-recursion
+avoid descending automatically in directories
+.TP
+\-\-no\-unquote
+do not unquote filenames read with \-T
+.HP
+\-\-null                 \-T reads null\-terminated names, disable \-C
+.TP
+\-N, \-\-newer=DATE\-OR\-FILE, \-\-after\-date=DATE\-OR\-FILE
+only store files newer than DATE\-OR\-FILE
+.TP
+\-\-one\-file\-system
+stay in local file system when creating archive
+.TP
+\-P, \-\-absolute\-names
+don't strip leading '/'s from file names
+.TP
+\-\-recursion
+recurse into directories (default)
+.TP
+\-\-suffix=STRING
+backup before removal, override usual suffix ('~'
+unless overridden by environment variable
+SIMPLE_BACKUP_SUFFIX)
+.TP
+\-T, \-\-files\-from=FILE
+get names to extract or create from FILE
+.TP
+\-\-unquote
+unquote filenames read with \-T (default)
+.TP
+\-X, \-\-exclude\-from=FILE
+exclude patterns listed in FILE
+.IP
+File name transformations:
+.TP
+\-\-strip\-components=NUMBER
+strip NUMBER leading components from file
+names on extraction
+.TP
+\-\-transform=EXPRESSION, \-\-xform=EXPRESSION
+use sed replace EXPRESSION to transform file
+names
+.IP
+File name matching options (affect both exclude and include patterns):
+.TP
+\-\-anchored
+patterns match file name start
+.TP
+\-\-ignore\-case
+ignore case
+.TP
+\-\-no\-anchored
+patterns match after any '/' (default for
+exclusion)
+.TP
+\-\-no\-ignore\-case
+case sensitive matching (default)
+.TP
+\-\-no\-wildcards
+verbatim string matching
+.TP
+\-\-no\-wildcards\-match\-slash
+wildcards do not match '/'
+.TP
+\-\-wildcards
+use wildcards (default for exclusion)
+.TP
+\-\-wildcards\-match\-slash
+wildcards match '/' (default for exclusion)
+.IP
+Informative output:
+.TP
+\-\-checkpoint[=NUMBER]
+display progress messages every NUMBERth record
+(default 10)
+.TP
+\-\-checkpoint\-action=ACTION
+execute ACTION on each checkpoint
+.TP
+\-\-full\-time
+print file time to its full resolution
+.TP
+\-\-index\-file=FILE
+send verbose output to FILE
+.TP
+\-l, \-\-check\-links
+print a message if not all links are dumped
+.TP
+\-\-no\-quote\-chars=STRING
+disable quoting for characters from STRING
+.TP
+\-\-quote\-chars=STRING
+additionally quote characters from STRING
+.TP
+\-\-quoting\-style=STYLE
+set name quoting style; see below for valid STYLE
+values
+.TP
+\-R, \-\-block\-number
+show block number within archive with each message
+.TP
+\-\-show\-defaults
+show tar defaults
+.TP
+\-\-show\-omitted\-dirs
+when listing or extracting, list each directory
+that does not match search criteria
+.TP
+\-\-show\-snapshot\-field\-ranges
+show valid ranges for snapshot\-file fields
+.TP
+\-\-show\-transformed\-names, \-\-show\-stored\-names
+show file or archive names after transformation
+.TP
+\-\-totals[=SIGNAL]
+print total bytes after processing the archive;
+with an argument \- print total bytes when this
+SIGNAL is delivered; Allowed signals are: SIGHUP,
+SIGQUIT, SIGINT, SIGUSR1 and SIGUSR2; the names
+without SIG prefix are also accepted
+.TP
+\-\-utc
+print file modification times in UTC
+.TP
+\-v, \-\-verbose
+verbosely list files processed
+.TP
+\-\-warning=KEYWORD
+warning control
+.TP
+\-w, \-\-interactive, \-\-confirmation
+ask for confirmation for every action
+.IP
+Compatibility options:
+.TP
+\-o
+when creating, same as \-\-old\-archive; when
+extracting, same as \-\-no\-same\-owner
+.IP
+Other options:
+.TP
+\-?, \-\-help
+give this help list
+.TP
+\-\-restrict
+disable use of some potentially harmful options
+.TP
+\-\-usage
+give a short usage message
+.TP
+\-\-version
+print program version
+.PP
+Mandatory or optional arguments to long options are also mandatory or optional
+for any corresponding short options.
+.PP
+The backup suffix is '~', unless set with \-\-suffix or SIMPLE_BACKUP_SUFFIX.
+The version control may be set with \-\-backup or VERSION_CONTROL, values are:
+.TP
+none, off
+never make backups
+.TP
+t, numbered
+make numbered backups
+.TP
+nil, existing
+numbered if numbered backups exist, simple otherwise
+.TP
+never, simple
+always make simple backups
+.PP
+Valid arguments for the \-\-quoting\-style option are:
+.IP
+literal
+shell
+shell\-always
+c
+c\-maybe
+escape
+locale
+clocale
+.PP
+*This* tar defaults to:
+\-\-format=gnu \-f\- \-b20 \-\-quoting\-style=escape
+\-\-rmt\-command=/opt/local/libexec/grmt \-\-rsh\-command=/usr/bin/rsh
+.SH AUTHOR
+Written by John Gilmore and Jay Fenlason.
+.SH "REPORTING BUGS"
+Report bugs to <bug\-tar@gnu.org>.
+.SH COPYRIGHT
+Copyright \(co 2013 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+The full documentation for
+.B tar
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B tar
+programs are properly installed at your site, the command
+.IP
+.B info tar
+.PP
+should give you access to the complete manual.