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 . .SH COPYRIGHT -Copyright \(co 2011 Free Software Foundation, Inc. +Copyright \(co 2013 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later . .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 - 1.27.1-2 +- sync manual page contents with help2man output + * Mon Nov 18 2013 Pavel Raiskup - 1.27.1-1 - minor version update to 1.27.1