X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=NEWS;h=380dc9670cf95388c59e789d268841adace41c64;hb=78b078b455b834695ebd3104ec3dbe8a4ac9f3a3;hp=f453c1ae25258c33200d2b44dabec1541e2e5e71;hpb=402b50d4d265544b70b22616b1a07627f1d2b570;p=chaz%2Ftar diff --git a/NEWS b/NEWS index f453c1a..380dc96 100644 --- a/NEWS +++ b/NEWS @@ -1,11 +1,110 @@ GNU tar NEWS - User visible changes. -Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003, 2004 -Free Software Foundation, Inc. -See the end for copying conditions. - Please send GNU tar bug reports to -version 1.14.1 - Sergey Poznyakoff, +version 1.15.2 (CVS version -- unreleased) + +* New features + +* Any number of -T (--files-from) options may be used in the command line. +The file specified with -T may include any valid `tar' options, +including another -T option. +Compatibility note: older versions of tar would only recognize -C +as an option name within the file list file. Now any file whose name +starts with - is handled as an option. To insert file names starting with +dash, use the --add-file option. + +* List files containing null-separated file names are detected and processed +automatically. It is no longer necessary to give the --null option. + +* New option --no-unquote disables the unquoting of input file names. +This is useful for processing output from `find dir -print0'. +An orthogonal option --unquote is provided as well. + +* New option --test-label tests the archive volume label. +If an argument is specified, the label is compared against its value. +Tar exits with code 0 if the two strings match, and with code 2 if +they do not. + +If no argument is given, the --verbose option is implied. In this case, +tar prints the label name if present and exits with code 0. + +* New option --show-stored-names. When creating an archive in verbose mode, +it lists member names as stored in the archive, i.e., with any eventual +prefixes removed. The option is useful, for example, while comparing +`tar cv' and `tar tv' outputs. + +* New option --to-command pipes the contents of archive members to the +specified command. + +* New option --atime-preserve=system, which uses the O_NOATIME feature +of recent Linux kernels to avoid some problems when preserving file +access times. + +* New option --delay-directory-restore delays restoring modification times +and permissions of extracted directories until the end of extraction. +This is necessary for restoring from archives with unusual member +ordering (in particular, those created with --no-recursion option). +This option is implied when restoring from incremental archives. + +* New option --restrict prohibits use of some potentially harmful tar +options. Currently it disables '!' escape in multi-volume name menu. + +* New options --quoting-style and --quote-chars control the way tar +quotes member names on output. The --quoting-style takes an argument +specifying the quoting style to use (literal, shell, shell-always, +c, escape, locale, clocale). The argument to --quote-chars is a string +specifying characters to quote, even if the selected quoting style +would not quote them otherwise. The option --no-quote-chars is +provided to disable quoting certain characters. + +* The end-of-volume script (introduced with --info-script option) can +get current archive name from the environment variable TAR_ARCHIVE and +the volume number from the variable TAR_VOLUME. It can alter the +archive name by writing new name to the file descriptor 3. + +* Better support for full-resolution time stamps. Tar cannot restore +time stamps to full nanosecond resolution, though, until the kernel +guys get their act together and give us a system call to set file time +stamps to nanosecond resolution. + +* The -v option now prints time stamps only to 1-minute resolution, +not full resolution, to avoid using up too many output columns. +Nanosecond resolution is now supported, but that would be too much. + +* Bug fixes + +** Allow non-option arguments to be interspersed with options. +** When extracting or listing archives in old GNU format, tar +used to read an extra block of data after a long name header +if length of the member name was divisible by block size (512). +Consequently, the file pointer was set off and the next member +was not processed correctly. +** Previous version created invalid archives when files shrink +during reading. +** Compare mode (tar d) hanged when trying to compare file contents. +** Previous versions in certain cases failed to restore directory +modification times. +** When creating an archive, do not attempt to store files whose +meta-data cannot be stored in the header due to format limitations +(for ustar and v7 formats). +** The --version option now also outputs information about copyright, +license, and credits. This reverts to the behavior of tar 1.14 and +earlier, and conforms to the GNU coding standards. The --license (-L) +option introduced in tar 1.15 has been removed, since it's no longer +needed. + + +version 1.15.1 - Sergey Poznyakoff, 2004-12-21 + +This version fixes a bug introduced in 1.15 which caused +tar to refuse to extract files from standard input. + + +version 1.15 - Sergey Poznyakoff, 2004-12-20 + +* Compressed archives are recognised automatically, it is no longer +necessary to specify -Z, -z, or -j options to read them. Thus, you can +now run `tar tf archive.tar.gz'. * When restoring incremental dumps, --one-file-system option prevents directory hierarchies residing on different devices @@ -14,10 +113,53 @@ from being purged. With the previous versions of tar it was dangerous to create incremental dumps with --one-file-system option, since they would recursively remove mount points when restoring from the -back up. This change fixes the bug. +back up. This change fixes the bug. * Renamed --strip-path to --strip-components for consistency with - the GNU convention. +the GNU convention. + +* Skipping archive members is sped up if the archive media supports +seeks. + +* Restore script starts restoring only if it is given --all (-a) option, +or some patterns. This is to prevent accidental restores. + +* `tar --verify' prints a warning if during archive creation some of +the file names had their prefixes stripped off. + +* New option --exclude-caches instructs tar to exclude cache directories +automatically on archive creation. Cache directories are those +containing a standardized tag file, as specified at: + + http://www.brynosaurus.com/cachedir/spec.html + +* New configure option --with-rmt allows to specify full path name to +the `rmt' utility. This supersedes DEFAULT_RMT_COMMAND variable +introduced in version 1.14 + +* New configure variable DEFAULT_RMT_DIR allows to specify the directory +where to install `rmt' utility. This is necessary since modifying +--libexecdir as was suggested for version 1.14 produced a side effect: it +also modified installation prefix for backup scripts (if +--enable-backup-scripts was given). + +* Bug fixes: +** Fixed flow in recognizing files to be included in incremental dumps. +** Correctly recognize sparse archive members when used with -T option. +** GNU multivolume headers cannot store filenames longer than 100 characters. +Do not allow multivolume archives to begin with such filenames. +** If a member with link count > 2 was stored in the archive twice, +previous versions of tar were not able to extract it, since they +were trying to link the file to itself, which always failed and +lead to removing the already extracted copy. Preserve the first +extracted copy in such cases. +** Restore script was passing improper argument to tar --listed option (which +didn't affect the functionality, but was logically incorrect). +** Fixed verification of created archives. +** Fixed unquoting of file names containing backslash escapes (previous +versions failed to recognize \a and \v). +** When attempting to delete a non-existing member from the archive, previous +versions of tar used to overwrite last archive block with zeroes. version 1.14 - Sergey Poznyakoff, 2004-05-11 @@ -34,28 +176,28 @@ version 1.14 - Sergey Poznyakoff, 2004-05-11 option is now the default; use --no-overwrite-dir if you prefer the previous default behavior. -* The semantics of -o option is changed. When extracting, it - does the same as --no-same-owner GNU tar option. This is compatible - with UNIX98 tar. Otherwise, its effect is the same as that of - --old-archive option. This latter is deprecated and will be removed +* The semantics of -o option is changed. When extracting, it + does the same as --no-same-owner GNU tar option. This is compatible + with UNIX98 tar. Otherwise, its effect is the same as that of + --old-archive option. This latter is deprecated and will be removed in future. * New option --check-links prints a message if not all links are dumped - for a file being archived. This corresponds to the UNIX98 -l option. + for a file being archived. This corresponds to the UNIX98 -l option. The current semantics of the -l option is retained for compatibility with previous releases, however such usage is strongly deprecated as the option will change to its UNIX98 semantics in the future releases. -* New option --occurrence[=N] can be used in conjunction with one of +* New option --occurrence[=N] can be used in conjunction with one of the subcommands --delete, --diff, --extract or --list when a list of - files is given either on the command line or via -T option. This + files is given either on the command line or via -T option. This option instructs tar to process only the Nth occurrence of each named - file. N defaults to 1, so `tar -x -f archive --occurrence filename' + file. N defaults to 1, so `tar -x -f archive --occurrence filename' extracts the first occurrence of `filename' from `archive' and terminates without scanning to the end of the archive. * New option --pax-option allows to control the handling of POSIX - keywords in `pax' extended headers. It is equivalent to `pax' + keywords in `pax' extended headers. It is equivalent to `pax' -o option. * --incremental and --listed-incremental options work correctly on @@ -67,18 +209,18 @@ option is given to configure. * By default tar searches "rmt" utility in "$prefix/libexec/rmt", which is consistent with the location where the version of "rmt" -included in the package is installed. Previous versions of tar -used "/etc/rmt". To install "rmt" to its traditional location, -run configure with option --libexecdir=/etc. Otherwise, if you +included in the package is installed. Previous versions of tar +used "/etc/rmt". To install "rmt" to its traditional location, +run configure with option --libexecdir=/etc. Otherwise, if you already have rmt installed and wish to use it, instead of the shipped in version, set the variable DEFAULT_RMT_COMMAND to -the full path name of the utility, e.g. ./configure +the full path name of the utility, e.g., ./configure DEFAULT_RMT_COMMAND=/etc/rmt. Notice also that the full path name of the "rmt" utility to use can be set at runtime, by giving option --rmt-command to -tar. - +tar. + * Removed obsolete command line options: ** --absolute-paths superseded by --absolute-names ** --block-compress is not needed any longer @@ -91,7 +233,7 @@ tar. * New message translations fi (Finnish), gl (Galician), hr (Croatian), hu (Hungarian), ms (Malaysian), nb (Norwegian), ro (Romanian), sk (Slovak), zh_CN (Chinese simplified), zh_TW (Chinese traditional). - The code 'no' for Norwegian (Bokmål) has been withdrawn; use 'nb' instead. + The code 'no' for Norwegian (BokmÃ¥l) has been withdrawn; use 'nb' instead. * Bug fixes. @@ -149,7 +291,7 @@ version 1.13.20 - Paul Eggert, 2001-08-27 The translation for Korean has been withdrawn due to encoding errors. It will be reissued once those are fixed. - + version 1.13.19 - Paul Eggert, 2001-01-13 * The -I option has been withdrawn, as it was buggy and confusing. @@ -158,7 +300,7 @@ version 1.13.19 - Paul Eggert, 2001-01-13 * With an option like -N DATE, if DATE starts with "/" or ".", it is taken to be a file name; the last-modified time of that file is used as the date. - + version 1.13.18 - Paul Eggert, 2000-10-29 * Some security problems have been fixed. `tar -x' now modifies only @@ -186,7 +328,7 @@ version 1.13.18 - Paul Eggert, 2000-10-29 * This version of tar works best with GNU gzip test version 1.3 or later. Please see . - + * `tar --delete -f -' now works again. @@ -218,7 +360,7 @@ version 1.13.16 - Paul Eggert, 1999-12-13. when extracting, and warns about such file names when creating an archive. To enable the old behavior, use the -P or --absolute-names option. -* Tar now handles file names with multibyte encodings (e.g. UTF-8, Shift-JIS) +* Tar now handles file names with multibyte encodings (e.g., UTF-8, Shift-JIS) correctly. It relies on the mbrtowc function to handle multibyte characters. * The file generated by -g or --listed-incremental now uses a format @@ -233,19 +375,19 @@ version 1.13.16 - Paul Eggert, 1999-12-13. `quoted like this' (in the default C locale) or are followed by colon, newline, or space, depending on context. Unprintable characters are escaped with a C-like backslash conventions. - Terminating characters (e.g. close-quote, colon, newline) + Terminating characters (e.g., close-quote, colon, newline) are also escaped as needed. * tar now ignores socket files when creating an archive. Previously tar archived sockets as fifos, which caused problems. - + version 1.13.15 - Paul Eggert, 1999-12-03. * If a file's ctime changes when being archived, report an error. Previously tar looked at mtime, which missed some errors. - + version 1.13.14 - Paul Eggert, 1999-11-07. * New translations ja, pt_BR. @@ -356,7 +498,7 @@ version 1.13.6 - Paul Eggert, 1999-08-11. * The protocol for talking to rmt has been extended slightly. Open flags are now communicated in symbolic format as well as numeric. - The symbolic format (e.g. "O_WRONLY|O_CREAT|O_TRUNC") is for portability + The symbolic format (e.g., "O_WRONLY|O_CREAT|O_TRUNC") is for portability when rmt is operating on a different operating system from tar. The numeric format is retained, and rmt uses it if symbolic format is absent, for backward compatibility with older versions of tar and rmt. @@ -404,7 +546,7 @@ version 1.13.1 - Paul Eggert, 1999-07-12. version 1.13 - Paul Eggert, 1999-07-08. -* Support for large files, e.g. files larger than 2 GB on many 32-bit hosts. +* Support for large files, e.g., files larger than 2 GB on many 32-bit hosts. Also, support for larger uids, device ids, etc. * Many bug fixes and porting fixes. * This release is only for fixes. A more ambitious test release, @@ -595,8 +737,8 @@ Versions 1.07 back to 1.00 by Jay Fenlason. -Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003 -Free Software Foundation, Inc. +Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2003, +2004, 2005, 2006 Free Software Foundation, Inc. This file is part of GNU tar. @@ -612,8 +754,8 @@ GNU General Public License for more details. You should have received a copy of the GNU General Public License along with tar; see the file COPYING. If not, write to -the Free Software Foundation, Inc., 59 Temple Place - Suite 330, -Boston, MA 02111-1307, USA. +the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, +Boston, MA 02110-1301, USA. Local variables: mode: outline