[pkgsrc/trunk]: pkgsrc/archivers/gtar-base For lack of a better source of gta...

[fhajny <fhajny%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/a4599d857cc7
branches:  trunk
changeset: 631702:a4599d857cc7
user:      fhajny <fhajny%pkgsrc.org@localhost>
date:      Wed Mar 12 13:32:14 2014 +0000

description:
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.

diffstat:

 archivers/gtar-base/Makefile     |   13 +-
 archivers/gtar-base/files/gtar.1 |  744 ++++++++++++++++++++++++++++----------
 2 files changed, 557 insertions(+), 200 deletions(-)

diffs (truncated from 844 to 300 lines):

diff -r 1bb29248fdd0 -r a4599d857cc7 archivers/gtar-base/Makefile
--- a/archivers/gtar-base/Makefile      Wed Mar 12 12:57:24 2014 +0000
+++ b/archivers/gtar-base/Makefile      Wed Mar 12 13:32:14 2014 +0000
@@ -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+=             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 -r 1bb29248fdd0 -r a4599d857cc7 archivers/gtar-base/files/gtar.1
--- a/archivers/gtar-base/files/gtar.1  Wed Mar 12 12:57:24 2014 +0000
+++ b/archivers/gtar-base/files/gtar.1  Wed Mar 12 13:32:14 2014 +0000
@@ -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 ]
+[\fIOPTION\fR...] [\fIFILE\fR]...
+.SH DESCRIPTION
+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
-.I filename1 \fR[\fP filename2\fR,\fP \fR...\fP filenameN \fR]
+tar \-tvf archive.tar
+# List all files in archive.tar verbosely.
 .TP
-.I directory1 \fR[\fP directory2\fR,\fP \fR...\fP directoryN \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"
+tar \-xf archive.tar
+# Extract all files from archive.tar.
+.IP
+Main operation mode:
 .TP
-.B One of the following options must be used:
-.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
+\-\-ignore\-failed\-read
+do not exit with nonzero on unreadable files
 .TP
-.B \-C, \-\-directory=\fIDIR
-change to directory \fIDIR
+\-\-level=NUMBER
+dump level for created listed\-incremental archive
 .TP
-.B \-\-checkpoint
-print directory names while reading the archive
+\-n, \-\-seek
+archive is seekable
 .TP
-.B \-f, \-\-file=\fR[\fP\fIHOSTNAME\fP:\fR]\fP\fIF
-use archive file or device \fIF\fP (default /dev/rmt0)
+\-\-no\-check\-device
+do not check device numbers when creating
+incremental archives
 .TP
-.B \-\-force\-local
-archive file is local even if has a colon
-.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)
-.TP
-.B \-j, \-\-bzip2, \-\-bunzip2
-filter the archive through bzip2
+\-k, \-\-keep\-old\-files
+don't replace existing files when extracting,
+treat them as errors
 .TP
-.B \-\-ignore\-failed\-read
-don't exit with non\-zero status on unreadable files
+\-\-keep\-directory\-symlink
+preserve existing symlinks to directories when
+extracting
 .TP
-.B \-k, \-\-keep\-old\-files
-keep existing files; don't overwrite them from archive
+\-\-keep\-newer\-files
+don't replace existing files that are newer than
+their archive copies
 .TP
-.B \-K, \-\-starting\-file=\fIF
-begin at file F in the archive
+\-\-no\-overwrite\-dir
+preserve metadata of existing directories
+.TP
+\-\-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
-.B \-L, \-\-tape\-length=\fIN
-change tapes after writing N*1024 bytes
+\-\-remove\-files
+remove files after adding them to the archive
 .TP
-.B \-m, \-\-modification\-time
-don't extract file modified time
+\-\-skip\-old\-files
+don't replace existing files when extracting,
+silently skip over them
 .TP
-.B \-M, \-\-multi\-volume
-create/list/extract multi\-volume archive
+\-U, \-\-unlink\-first
+remove each file prior to extracting over it
 .TP