Update

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index 229523447197e68dff51a1a3701911548c107a47..f5029440df2c4c18a717c72b896fb9f0f7a1ae15 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -3,12 +3,78 @@ Please send GNU tar bug reports to <bug-tar@gnu.org>
 \f
 version 1.15.91 - Sergey Poznyakoff, (CVS version)
 
+* Incompatible changes
+
+** Globbing
+
+Previous versions of GNU tar assumed shell-style globbing when
+extracting from or listing an archive.  For example:
+
+  tar xf foo.tar '*.c'
+
+would extract all files whose names end in '.c'.  This behavior
+was not documented and was incompatible with traditional tar
+implementations.  Therefore, starting from this version, GNU tar
+no longer uses globbing by default.  For example, the above invocation
+is now interpreted as a request to extract from the archive the file
+named '*.c'.
+
+To treat member names as globbing patterns, use --wildcards option.  
+So, if you wish tar to mimic the behavior of versions up to 1.15.90,
+set 'TAR_OPTIONS=--wildcards'.
+
+The exact way tar interprets member names is controlled by the
+following command line options:
+
+     --wildcards              use wildcards 
+     --anchored               patterns match file name start
+     --ignore-case            ignore case
+     --wildcards-match-slash  wildcards match `/'
+
+Each of these options has a '--no-' counterpart that disables its
+effect (e.g. --no-wildcards).
+
+These options affect both the interpretation of member names from 
+command line and that of the exclusion patterns (given with --exclude
+and --exclude-from options). The defaults are:
+
+ 1. For member names: --no-wildcards --anchored
+ 2. For exclusion patterns: --wildcards --no-anchored --wildcards-match-slash
+
+The options can appear multiple times in the command line, thereby
+changing the way command line arguments are interpreted.  For example,
+to use case-insensitive matching in exclude patterns and to revert to
+case-sensitive matching for the rest of command line, one could write:
+
+  tar xf foo.tar --ignore-case --exclude-from=FILE --no-ignore-case file.name
+
+** Short option -l is now an alias of --check-links option, which complies
+with UNIX98.  This ends the transition period started with version 1.14.
+  
 * New features
 
+** New option --transform allows to transform file names before storing them
+in the archive or member names before extracting.  The option takes a
+sed replace expression as its argument.  For example,
+
+  tar cf foo.tar --transform 's,^,prefix/'
+
+will add 'prefix/' to all file names stored in foo.tar.
+
+** --strip-components option works when deleting and comparing.
+
+** New option --show-transformed-names enables display of transformed file
+or archive.  In particular, when creating archive in verbose mode,
+the option lists member names as stored in the archive.  It
+generalizes --show-stored-names option, introduced in 1.15.90.  In
+particular, when creating an archive in verbose mode, it lists member
+names as stored in the archive, i.e., with any eventual prefixes
+removed and file name transformations applied.  The option is useful,
+for example, while comparing `tar cv' and `tar tv' outputs.
+
 ** New incremental snapshot file format keeps information about file names 
 as well as that about directories.
 
-
 \f
 version 1.15.90 - Sergey Poznyakoff, 2006-02-19