[tar] man: sync with help2man
Pavel Raiskup
praiskup at fedoraproject.org
Fri Nov 29 07:34:05 UTC 2013
commit e6f5bb4d09c8ed4fa5492189657274ee7cd8b48b
Author: Pavel Raiskup <praiskup at redhat.com>
Date: Fri Nov 29 08:31:44 2013 +0100
man: sync with help2man
Version: 1.27.1-2
last_help2man_run | 367 +++++++++++++++++++++++++++--------------------------
tar.1 | 29 +++--
tar.spec | 5 +-
3 files changed, 211 insertions(+), 190 deletions(-)
---
diff --git a/last_help2man_run b/last_help2man_run
index cafa14d..4df9a05 100644
--- a/last_help2man_run
+++ b/last_help2man_run
@@ -1,272 +1,277 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.12.
-.TH TAR "1" "February 2013" "tar 1.26" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
+.TH TAR "1" "November 2013" "tar 1.27.1" "User Commands"
.SH NAME
-tar \- manual page for tar 1.26
+tar \- manual page for tar 1.27.1
.SH SYNOPSIS
.B tar
[\fIOPTION\fR...] [\fIFILE\fR]...
.SH DESCRIPTION
-GNU `tar' saves many files together into a single tape or disk archive, and can
+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 \fB\-cf\fR archive.tar foo bar
+tar \-cf archive.tar foo bar
# Create archive.tar from files foo and bar.
.TP
-tar \fB\-tvf\fR archive.tar
+tar \-tvf archive.tar
# List all files in archive.tar verbosely.
.TP
-tar \fB\-xf\fR archive.tar
+tar \-xf archive.tar
# Extract all files from archive.tar.
.IP
Main operation mode:
.TP
-\fB\-A\fR, \fB\-\-catenate\fR, \fB\-\-concatenate\fR
+\-A, \-\-catenate, \-\-concatenate
append tar files to an archive
.TP
-\fB\-c\fR, \fB\-\-create\fR
+\-c, \-\-create
create a new archive
.TP
-\fB\-d\fR, \fB\-\-diff\fR, \fB\-\-compare\fR
+\-d, \-\-diff, \-\-compare
find differences between archive and file system
.TP
-\fB\-\-delete\fR
+\-\-delete
delete from the archive (not on mag tapes!)
.TP
-\fB\-r\fR, \fB\-\-append\fR
+\-r, \-\-append
append files to the end of an archive
.TP
-\fB\-t\fR, \fB\-\-list\fR
+\-t, \-\-list
list the contents of an archive
.TP
-\fB\-\-test\-label\fR
+\-\-test\-label
test the archive volume label and exit
.TP
-\fB\-u\fR, \fB\-\-update\fR
+\-u, \-\-update
only append files newer than copy in archive
.TP
-\fB\-x\fR, \fB\-\-extract\fR, \fB\-\-get\fR
+\-x, \-\-extract, \-\-get
extract files from an archive
.IP
Operation modifiers:
.TP
-\fB\-\-check\-device\fR
+\-\-check\-device
check device numbers when creating incremental
archives (default)
.TP
-\fB\-g\fR, \fB\-\-listed\-incremental\fR=\fIFILE\fR
+\-g, \-\-listed\-incremental=FILE
handle new GNU\-format incremental backup
.TP
-\fB\-G\fR, \fB\-\-incremental\fR
+\-G, \-\-incremental
handle old GNU\-format incremental backup
.TP
-\fB\-\-ignore\-failed\-read\fR
+\-\-ignore\-failed\-read
do not exit with nonzero on unreadable files
.TP
-\fB\-\-level\fR=\fINUMBER\fR
+\-\-level=NUMBER
dump level for created listed\-incremental archive
.TP
-\fB\-n\fR, \fB\-\-seek\fR
+\-n, \-\-seek
archive is seekable
.TP
-\fB\-\-no\-check\-device\fR
+\-\-no\-check\-device
do not check device numbers when creating
incremental archives
.TP
-\fB\-\-no\-seek\fR
+\-\-no\-seek
archive is not seekable
.TP
-\fB\-\-occurrence\fR[=\fINUMBER\fR]
+\-\-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 \fB\-\-delete\fR,
-\fB\-\-diff\fR, \fB\-\-extract\fR or \fB\-\-list\fR and when a list of
+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 \fB\-T\fR option; NUMBER defaults to 1
+the \-T option; NUMBER defaults to 1
.TP
-\fB\-\-sparse\-version\fR=\fIMAJOR[\fR.MINOR]
+\-\-sparse\-version=MAJOR[.MINOR]
set version of the sparse format to use (implies
-\fB\-\-sparse\fR)
+\-\-sparse)
.TP
-\fB\-S\fR, \fB\-\-sparse\fR
+\-S, \-\-sparse
handle sparse files efficiently
.IP
Overwrite control:
.TP
-\fB\-k\fR, \fB\-\-keep\-old\-files\fR
+\-k, \-\-keep\-old\-files
don't replace existing files when extracting,
treat them as errors
.TP
-\fB\-\-keep\-newer\-files\fR
+\-\-keep\-directory\-symlink
+preserve existing symlinks to directories when
+extracting
+.TP
+\-\-keep\-newer\-files
don't replace existing files that are newer than
their archive copies
.TP
-\fB\-\-no\-overwrite\-dir\fR
+\-\-no\-overwrite\-dir
preserve metadata of existing directories
.TP
-\fB\-\-overwrite\fR
+\-\-overwrite
overwrite existing files when extracting
.TP
-\fB\-\-overwrite\-dir\fR
+\-\-overwrite\-dir
overwrite metadata of existing directories when
extracting (default)
.TP
-\fB\-\-recursive\-unlink\fR
+\-\-recursive\-unlink
empty hierarchies prior to extracting directory
.TP
-\fB\-\-remove\-files\fR
+\-\-remove\-files
remove files after adding them to the archive
.TP
-\fB\-\-skip\-old\-files\fR
+\-\-skip\-old\-files
don't replace existing files when extracting,
silently skip over them
.TP
-\fB\-U\fR, \fB\-\-unlink\-first\fR
+\-U, \-\-unlink\-first
remove each file prior to extracting over it
.TP
-\fB\-W\fR, \fB\-\-verify\fR
+\-W, \-\-verify
attempt to verify the archive after writing it
.IP
Select output stream:
.HP
-\fB\-\-ignore\-command\-error\fR ignore exit codes of children
+\-\-ignore\-command\-error ignore exit codes of children
.TP
-\fB\-\-no\-ignore\-command\-error\fR
+\-\-no\-ignore\-command\-error
treat non\-zero exit codes of children as
error
.TP
-\fB\-O\fR, \fB\-\-to\-stdout\fR
+\-O, \-\-to\-stdout
extract files to standard output
.TP
-\fB\-\-to\-command\fR=\fICOMMAND\fR
+\-\-to\-command=COMMAND
pipe extracted files to another program
.IP
Handling of file attributes:
.TP
-\fB\-\-atime\-preserve\fR[=\fIMETHOD\fR]
+\-\-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
-\fB\-\-delay\-directory\-restore\fR
+\-\-delay\-directory\-restore
delay setting modification times and
permissions of extracted directories until the end
of extraction
.TP
-\fB\-\-group\fR=\fINAME\fR
+\-\-group=NAME
force NAME as group for added files
.TP
-\fB\-\-mode\fR=\fICHANGES\fR
+\-\-mode=CHANGES
force (symbolic) mode CHANGES for added files
.TP
-\fB\-\-mtime\fR=\fIDATE\-OR\-FILE\fR
+\-\-mtime=DATE\-OR\-FILE
set mtime for added files from DATE\-OR\-FILE
.TP
-\fB\-m\fR, \fB\-\-touch\fR
+\-m, \-\-touch
don't extract file modified time
.TP
-\fB\-\-no\-delay\-directory\-restore\fR
-cancel the effect of \fB\-\-delay\-directory\-restore\fR
+\-\-no\-delay\-directory\-restore
+cancel the effect of \-\-delay\-directory\-restore
option
.TP
-\fB\-\-no\-same\-owner\fR
+\-\-no\-same\-owner
extract files as yourself (default for ordinary
users)
.TP
-\fB\-\-no\-same\-permissions\fR
+\-\-no\-same\-permissions
apply the user's umask when extracting permissions
from the archive (default for ordinary users)
.TP
-\fB\-\-numeric\-owner\fR
+\-\-numeric\-owner
always use numbers for user/group names
.TP
-\fB\-\-owner\fR=\fINAME\fR
+\-\-owner=NAME
force NAME as owner for added files
.TP
-\fB\-p\fR, \fB\-\-preserve\-permissions\fR, \fB\-\-same\-permissions\fR
+\-p, \-\-preserve\-permissions, \-\-same\-permissions
extract information about file permissions
(default for superuser)
.TP
-\fB\-\-preserve\fR
-same as both \fB\-p\fR and \fB\-s\fR
+\-\-preserve
+same as both \-p and \-s
.TP
-\fB\-\-same\-owner\fR
+\-\-same\-owner
try extracting files with the same ownership as
exists in the archive (default for superuser)
.TP
-\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR
-sort names to extract to match archive
+\-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
-\fB\-\-acls\fR
+\-\-acls
Enable the POSIX ACLs support
.TP
-\fB\-\-no\-acls\fR
+\-\-no\-acls
Disable the POSIX ACLs support
.TP
-\fB\-\-no\-selinux\fR
+\-\-no\-selinux
Disable the SELinux context support
.TP
-\fB\-\-no\-xattrs\fR
+\-\-no\-xattrs
Disable extended attributes support
.TP
-\fB\-\-selinux\fR
+\-\-selinux
Enable the SELinux context support
.TP
-\fB\-\-xattrs\fR
+\-\-xattrs
Enable extended attributes support
.TP
-\fB\-\-xattrs\-exclude\fR=\fIMASK\fR
+\-\-xattrs\-exclude=MASK
specify the exclude pattern for xattr keys
.TP
-\fB\-\-xattrs\-include\fR=\fIMASK\fR
+\-\-xattrs\-include=MASK
specify the include pattern for xattr keys
.IP
Device selection and switching:
.TP
-\fB\-f\fR, \fB\-\-file\fR=\fIARCHIVE\fR
+\-f, \-\-file=ARCHIVE
use archive file or device ARCHIVE
.TP
-\fB\-\-force\-local\fR
+\-\-force\-local
archive file is local even if it has a colon
.TP
-\fB\-F\fR, \fB\-\-info\-script\fR=\fINAME\fR, \fB\-\-new\-volume\-script\fR=\fINAME\fR
-run script at end of each tape (implies \fB\-M\fR)
+\-F, \-\-info\-script=NAME, \-\-new\-volume\-script=NAME
+run script at end of each tape (implies \-M)
.TP
-\fB\-L\fR, \fB\-\-tape\-length\fR=\fINUMBER\fR
+\-L, \-\-tape\-length=NUMBER
change tape after writing NUMBER x 1024 bytes
.TP
-\fB\-M\fR, \fB\-\-multi\-volume\fR
+\-M, \-\-multi\-volume
create/list/extract multi\-volume archive
.TP
-\fB\-\-rmt\-command\fR=\fICOMMAND\fR
+\-\-rmt\-command=COMMAND
use given rmt COMMAND instead of rmt
.TP
-\fB\-\-rsh\-command\fR=\fICOMMAND\fR
+\-\-rsh\-command=COMMAND
use remote COMMAND instead of rsh
.TP
-\fB\-\-volno\-file\fR=\fIFILE\fR
+\-\-volno\-file=FILE
use/update the volume number in FILE
.IP
Device blocking:
.TP
-\fB\-b\fR, \fB\-\-blocking\-factor\fR=\fIBLOCKS\fR
+\-b, \-\-blocking\-factor=BLOCKS
BLOCKS x 512 bytes per record
.TP
-\fB\-B\fR, \fB\-\-read\-full\-records\fR
+\-B, \-\-read\-full\-records
reblock as we read (for 4.2BSD pipes)
.TP
-\fB\-i\fR, \fB\-\-ignore\-zeros\fR
+\-i, \-\-ignore\-zeros
ignore zeroed blocks in archive (means EOF)
.TP
-\fB\-\-record\-size\fR=\fINUMBER\fR
+\-\-record\-size=NUMBER
NUMBER of bytes per record, multiple of 512
.IP
Archive format selection:
.TP
-\fB\-H\fR, \fB\-\-format\fR=\fIFORMAT\fR
+\-H, \-\-format=FORMAT
create archive of the given format
.IP
FORMAT is one of the following:
@@ -289,267 +294,271 @@ POSIX 1003.1\-1988 (ustar) format
v7
old V7 tar format
.TP
-\fB\-\-old\-archive\fR, \fB\-\-portability\fR
-same as \fB\-\-format\fR=\fIv7\fR
+\-\-old\-archive, \-\-portability
+same as \-\-format=v7
.TP
-\fB\-\-pax\-option\fR=\fIkeyword[[\fR:]=value][,keyword[[:]=value]]...
+\-\-pax\-option=keyword[[:]=value][,keyword[[:]=value]]...
control pax keywords
.TP
-\fB\-\-posix\fR
-same as \fB\-\-format\fR=\fIposix\fR
+\-\-posix
+same as \-\-format=posix
.TP
-\fB\-V\fR, \fB\-\-label\fR=\fITEXT\fR
+\-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
-\fB\-a\fR, \fB\-\-auto\-compress\fR
+\-a, \-\-auto\-compress
use archive suffix to determine the compression
program
.TP
-\fB\-I\fR, \fB\-\-use\-compress\-program\fR=\fIPROG\fR
-filter through PROG (must accept \fB\-d\fR)
+\-I, \-\-use\-compress\-program=PROG
+filter through PROG (must accept \-d)
.TP
-\fB\-j\fR, \fB\-\-bzip2\fR
+\-j, \-\-bzip2
filter the archive through bzip2
.TP
-\fB\-J\fR, \fB\-\-xz\fR
+\-J, \-\-xz
filter the archive through xz
.TP
-\fB\-\-lzip\fR
+\-\-lzip
filter the archive through lzip
.TP
-\fB\-\-lzma\fR
-filter the archive through lzma
+\-\-lzma
+filter the archive through xz \-\-format=lzma
.HP
-\fB\-\-lzop\fR
+\-\-lzop
.TP
-\fB\-\-no\-auto\-compress\fR
+\-\-no\-auto\-compress
do not use archive suffix to determine the
compression program
.TP
-\fB\-z\fR, \fB\-\-gzip\fR, \fB\-\-gunzip\fR, \fB\-\-ungzip\fR
+\-z, \-\-gzip, \-\-gunzip, \-\-ungzip
filter the archive through gzip
.TP
-\fB\-Z\fR, \fB\-\-compress\fR, \fB\-\-uncompress\fR
+\-Z, \-\-compress, \-\-uncompress
filter the archive through compress
.IP
Local file selection:
.TP
-\fB\-\-add\-file\fR=\fIFILE\fR
+\-\-add\-file=FILE
add given FILE to the archive (useful if its name
starts with a dash)
.TP
-\fB\-\-backup\fR[=\fICONTROL\fR]
+\-\-backup[=CONTROL]
backup before removal, choose version CONTROL
.TP
-\fB\-C\fR, \fB\-\-directory\fR=\fIDIR\fR
+\-C, \-\-directory=DIR
change to directory DIR
.TP
-\fB\-\-exclude\fR=\fIPATTERN\fR
+\-\-exclude=PATTERN
exclude files, given as a PATTERN
.TP
-\fB\-\-exclude\-backups\fR
+\-\-exclude\-backups
exclude backup and lock files
.TP
-\fB\-\-exclude\-caches\fR
+\-\-exclude\-caches
exclude contents of directories containing
CACHEDIR.TAG, except for the tag file itself
.TP
-\fB\-\-exclude\-caches\-all\fR
+\-\-exclude\-caches\-all
exclude directories containing CACHEDIR.TAG
.TP
-\fB\-\-exclude\-caches\-under\fR exclude everything under directories containing
+\-\-exclude\-caches\-under exclude everything under directories containing
CACHEDIR.TAG
.TP
-\fB\-\-exclude\-tag\fR=\fIFILE\fR
+\-\-exclude\-tag=FILE
exclude contents of directories containing FILE,
except for FILE itself
.HP
-\fB\-\-exclude\-tag\-all\fR=\fIFILE\fR exclude directories containing FILE
+\-\-exclude\-tag\-all=FILE exclude directories containing FILE
.TP
-\fB\-\-exclude\-tag\-under\fR=\fIFILE\fR
+\-\-exclude\-tag\-under=FILE
exclude everything under directories
containing FILE
.TP
-\fB\-\-exclude\-vcs\fR
+\-\-exclude\-vcs
exclude version control system directories
.TP
-\fB\-h\fR, \fB\-\-dereference\fR
+\-h, \-\-dereference
follow symlinks; archive and dump the files they
point to
.TP
-\fB\-\-hard\-dereference\fR
+\-\-hard\-dereference
follow hard links; archive and dump the files they
refer to
.TP
-\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\-NAME\fR
-begin at member MEMBER\-NAME in the archive
+\-K, \-\-starting\-file=MEMBER\-NAME
+begin at member MEMBER\-NAME when reading the
+archive
.TP
-\fB\-\-newer\-mtime\fR=\fIDATE\fR
+\-\-newer\-mtime=DATE
compare date and time when data changed only
.TP
-\fB\-\-no\-null\fR
-disable the effect of the previous \fB\-\-null\fR option
+\-\-no\-null
+disable the effect of the previous \-\-null option
.TP
-\fB\-\-no\-recursion\fR
+\-\-no\-recursion
avoid descending automatically in directories
.TP
-\fB\-\-no\-unquote\fR
-do not unquote filenames read with \fB\-T\fR
+\-\-no\-unquote
+do not unquote filenames read with \-T
.HP
-\fB\-\-null\fR \fB\-T\fR reads null\-terminated names, disable \fB\-C\fR
+\-\-null \-T reads null\-terminated names, disable \-C
.TP
-\fB\-N\fR, \fB\-\-newer\fR=\fIDATE\-OR\-FILE\fR, \fB\-\-after\-date\fR=\fIDATE\-OR\-FILE\fR
+\-N, \-\-newer=DATE\-OR\-FILE, \-\-after\-date=DATE\-OR\-FILE
only store files newer than DATE\-OR\-FILE
.TP
-\fB\-\-one\-file\-system\fR
+\-\-one\-file\-system
stay in local file system when creating archive
.TP
-\fB\-P\fR, \fB\-\-absolute\-names\fR
-don't strip leading `/'s from file names
+\-P, \-\-absolute\-names
+don't strip leading '/'s from file names
.TP
-\fB\-\-recursion\fR
+\-\-recursion
recurse into directories (default)
.TP
-\fB\-\-suffix\fR=\fISTRING\fR
+\-\-suffix=STRING
backup before removal, override usual suffix ('~'
unless overridden by environment variable
SIMPLE_BACKUP_SUFFIX)
.TP
-\fB\-T\fR, \fB\-\-files\-from\fR=\fIFILE\fR
+\-T, \-\-files\-from=FILE
get names to extract or create from FILE
.TP
-\fB\-\-unquote\fR
-unquote filenames read with \fB\-T\fR (default)
+\-\-unquote
+unquote filenames read with \-T (default)
.TP
-\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
+\-X, \-\-exclude\-from=FILE
exclude patterns listed in FILE
.IP
File name transformations:
.TP
-\fB\-\-strip\-components\fR=\fINUMBER\fR
+\-\-strip\-components=NUMBER
strip NUMBER leading components from file
names on extraction
.TP
-\fB\-\-transform\fR=\fIEXPRESSION\fR, \fB\-\-xform\fR=\fIEXPRESSION\fR
+\-\-transform=EXPRESSION, \-\-xform=EXPRESSION
use sed replace EXPRESSION to transform file
names
.IP
File name matching options (affect both exclude and include patterns):
.TP
-\fB\-\-anchored\fR
+\-\-anchored
patterns match file name start
.TP
-\fB\-\-ignore\-case\fR
+\-\-ignore\-case
ignore case
.TP
-\fB\-\-no\-anchored\fR
-patterns match after any `/' (default for
+\-\-no\-anchored
+patterns match after any '/' (default for
exclusion)
.TP
-\fB\-\-no\-ignore\-case\fR
+\-\-no\-ignore\-case
case sensitive matching (default)
.TP
-\fB\-\-no\-wildcards\fR
+\-\-no\-wildcards
verbatim string matching
.TP
-\fB\-\-no\-wildcards\-match\-slash\fR
-wildcards do not match `/'
+\-\-no\-wildcards\-match\-slash
+wildcards do not match '/'
.TP
-\fB\-\-wildcards\fR
+\-\-wildcards
use wildcards (default)
.TP
-\fB\-\-wildcards\-match\-slash\fR
-wildcards match `/' (default for exclusion)
+\-\-wildcards\-match\-slash
+wildcards match '/' (default for exclusion)
.IP
Informative output:
.TP
-\fB\-\-checkpoint\fR[=\fINUMBER\fR]
+\-\-checkpoint[=NUMBER]
display progress messages every NUMBERth record
(default 10)
.TP
-\fB\-\-checkpoint\-action\fR=\fIACTION\fR
+\-\-checkpoint\-action=ACTION
execute ACTION on each checkpoint
.TP
-\fB\-\-full\-time\fR
+\-\-full\-time
print file time to its full resolution
.TP
-\fB\-\-index\-file\fR=\fIFILE\fR
+\-\-index\-file=FILE
send verbose output to FILE
.TP
-\fB\-l\fR, \fB\-\-check\-links\fR
+\-l, \-\-check\-links
print a message if not all links are dumped
.TP
-\fB\-\-no\-quote\-chars\fR=\fISTRING\fR
+\-\-no\-quote\-chars=STRING
disable quoting for characters from STRING
.TP
-\fB\-\-quote\-chars\fR=\fISTRING\fR
+\-\-quote\-chars=STRING
additionally quote characters from STRING
.TP
-\fB\-\-quoting\-style\fR=\fISTYLE\fR
+\-\-quoting\-style=STYLE
set name quoting style; see below for valid STYLE
values
.TP
-\fB\-R\fR, \fB\-\-block\-number\fR
+\-R, \-\-block\-number
show block number within archive with each message
.TP
-\fB\-\-show\-defaults\fR
+\-\-show\-defaults
show tar defaults
.TP
-\fB\-\-show\-omitted\-dirs\fR
+\-\-show\-omitted\-dirs
when listing or extracting, list each directory
that does not match search criteria
.TP
-\fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
+\-\-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
-\fB\-\-totals\fR[=\fISIGNAL\fR]
+\-\-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
-\fB\-\-utc\fR
+\-\-utc
print file modification times in UTC
.TP
-\fB\-v\fR, \fB\-\-verbose\fR
+\-v, \-\-verbose
verbosely list files processed
.TP
-\fB\-\-warning\fR=\fIKEYWORD\fR
+\-\-warning=KEYWORD
warning control
.TP
-\fB\-w\fR, \fB\-\-interactive\fR, \fB\-\-confirmation\fR
+\-w, \-\-interactive, \-\-confirmation
ask for confirmation for every action
.IP
Compatibility options:
.TP
-\fB\-o\fR
-when creating, same as \fB\-\-old\-archive\fR; when
-extracting, same as \fB\-\-no\-same\-owner\fR
+\-o
+when creating, same as \-\-old\-archive; when
+extracting, same as \-\-no\-same\-owner
.IP
Other options:
.TP
-\-?, \fB\-\-help\fR
+\-?, \-\-help
give this help list
.TP
-\fB\-\-restrict\fR
+\-\-restrict
disable use of some potentially harmful options
.TP
-\fB\-\-usage\fR
+\-\-usage
give a short usage message
.TP
-\fB\-\-version\fR
+\-\-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 \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
-The version control may be set with \fB\-\-backup\fR or VERSION_CONTROL, values are:
+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
@@ -563,7 +572,7 @@ numbered if numbered backups exist, simple otherwise
never, simple
always make simple backups
.PP
-Valid arguments for the \fB\-\-quoting\-style\fR option are:
+Valid arguments for the \-\-quoting\-style option are:
.IP
literal
shell
@@ -575,14 +584,14 @@ locale
clocale
.PP
*This* tar defaults to:
-\fB\-\-format\fR=\fIgnu\fR \fB\-f\-\fR \fB\-b20\fR \fB\-\-quoting\-style\fR=\fIescape\fR \fB\-\-rmt\-command=\fR/sbin/rmt
-\fB\-\-rsh\-command=\fR/usr/bin/rsh
+\-\-format=gnu \-f\- \-b20 \-\-quoting\-style=escape \-\-rmt\-command=/etc/rmt
+\-\-rsh\-command=/usr/bin/ssh
.SH AUTHOR
Written by John Gilmore and Jay Fenlason.
.SH "REPORTING BUGS"
Report bugs to <bug\-tar at gnu.org>.
.SH COPYRIGHT
-Copyright \(co 2011 Free Software Foundation, Inc.
+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.
diff --git a/tar.1 b/tar.1
index d202788..6554f7c 100644
--- a/tar.1
+++ b/tar.1
@@ -1,12 +1,12 @@
.\" This file was originally generated by help2man
-.TH TAR "1" "February 2013" "tar 1.26" "User Commands"
+.TH TAR "1" "November 2013" "tar 1.27.1" "User Commands"
.SH NAME
tar \- an archiver tool
.SH SYNOPSIS
.B tar
[\fIOPTION\fR...] [\fIFILE\fR]...
.SH DESCRIPTION
-GNU `tar' saves many files together into a single tape or disk archive, and can
+GNU 'tar' saves many files together into a single tape or disk archive, and can
restore individual files from the archive.
Note that this manual page contains just very brief description (or more like
@@ -20,7 +20,7 @@ is maintained as a Texinfo manual. If the
and
.B tar
programs are properly installed at your site, the command
-.B `info tar'
+.B 'info tar'
should give you access to the complete manual.
.SH EXAMPLES
.TP
@@ -139,6 +139,10 @@ handle sparse files efficiently
don't replace existing files when extracting,
treat them as errors
.TP
+\fB\-\-keep\-directory\-symlink\fR
+preserve existing symlinks to directories when
+extracting
+.TP
\fB\-\-keep\-newer\-files\fR
don't replace existing files that are newer than
their archive copies
@@ -238,7 +242,8 @@ try extracting files with the same ownership as
exists in the archive (default for superuser)
.TP
\fB\-s\fR, \fB\-\-preserve\-order\fR, \fB\-\-same\-order\fR
-sort names to extract to match archive
+member arguments are listed in the same order as
+the files in the archive
.IP
.SH \fBHandling of extended file attributes:\fR
.TP
@@ -433,7 +438,8 @@ follow hard links; archive and dump the files they
refer to
.TP
\fB\-K\fR, \fB\-\-starting\-file\fR=\fIMEMBER\-NAME\fR
-begin at member MEMBER\-NAME in the archive
+begin at member MEMBER\-NAME when reading the
+archive
.TP
\fB\-\-newer\-mtime\fR=\fIDATE\fR
compare date and time when data changed only
@@ -456,7 +462,7 @@ only store files newer than DATE\-OR\-FILE
stay in local file system when creating archive
.TP
\fB\-P\fR, \fB\-\-absolute\-names\fR
-don't strip leading `/'s from file names
+don't strip leading '/'s from file names
.TP
\fB\-\-recursion\fR
recurse into directories (default)
@@ -494,7 +500,7 @@ patterns match file name start
ignore case
.TP
\fB\-\-no\-anchored\fR
-patterns match after any `/' (default for
+patterns match after any '/' (default for
exclusion)
.TP
\fB\-\-no\-ignore\-case\fR
@@ -504,13 +510,13 @@ case sensitive matching (default)
verbatim string matching
.TP
\fB\-\-no\-wildcards\-match\-slash\fR
-wildcards do not match `/'
+wildcards do not match '/'
.TP
\fB\-\-wildcards\fR
use wildcards (default)
.TP
\fB\-\-wildcards\-match\-slash\fR
-wildcards match `/' (default for exclusion)
+wildcards match '/' (default for exclusion)
.IP
.SH \fBInformative output:\fR
.TP
@@ -551,6 +557,9 @@ show tar defaults
when listing or extracting, list each directory
that does not match search criteria
.TP
+\fB\-\-show\-snapshot\-field\-ranges\fR
+show valid ranges for snapshot\-file fields
+.TP
\fB\-\-show\-transformed\-names\fR, \fB\-\-show\-stored\-names\fR
show file or archive names after transformation
.TP
@@ -597,7 +606,7 @@ print program version
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 \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
+The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
The version control may be set with \fB\-\-backup\fR or VERSION_CONTROL, values are:
.TP
none, off
diff --git a/tar.spec b/tar.spec
index 8c31194..c0b0a64 100644
--- a/tar.spec
+++ b/tar.spec
@@ -5,7 +5,7 @@ Summary: A GNU file archiving program
Name: tar
Epoch: 2
Version: 1.27.1
-Release: 1%{?dist}
+Release: 2%{?dist}
License: GPLv3+
Group: Applications/Archiving
URL: http://www.gnu.org/software/tar/
@@ -163,6 +163,9 @@ fi
%{_infodir}/tar.info*
%changelog
+* Fri Nov 29 2013 Pavel Raiskup <praiskup at redhat.com> - 1.27.1-2
+- sync manual page contents with help2man output
+
* Mon Nov 18 2013 Pavel Raiskup <praiskup at redhat.com> - 1.27.1-1
- minor version update to 1.27.1
More information about the scm-commits
mailing list