Fix --one-top-level used together with --list.

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index ced28e07825aea0b6c435248efde39b87bb413ec..5cbd1270ae693d0f2be89719ddb1dd12d4149464 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-GNU tar NEWS - User visible changes. 2014-01-27
+GNU tar NEWS - User visible changes. 2014-02-13

 Please send GNU tar bug reports to <bug-tar@gnu.org>
 
 \f
 Please send GNU tar bug reports to <bug-tar@gnu.org>
 
 \f


@@ -15,15 +15,25 @@ New conversion specifiers are implemented.  Some of them take
 optional arguments, supplied in curly braces between the percent
 sign and the specifier letter.
 
 optional arguments, supplied in curly braces between the percent
 sign and the specifier letter.
 

-  %d        -  output number of seconds since tar started
-  %{r,w,d}T -  output I/O totals; optional arguments supply prefixes
+  %d        -  Number of seconds since tar started.
+  %{r,w,d}T -  I/O totals; optional arguments supply prefixes

                to be used before number of bytes read, written and
               deleted, correspondingly.
                to be used before number of bytes read, written and
               deleted, correspondingly.

-  %{FMT}t   -  output current local time using FMT as strftime(3) format
-               If {FMT} is omitted, use %c
-  %{N}*     - pad output with spaces to the Nth column, or to the 
-              current screen width, if {N} is not given.
-  %c        -  a shortcut for "%{%Y-%m-%d %H:%M:%S}t: %ds, %{read,wrote}T%*\r"
+  %{FMT}t   -  Current local time using FMT as strftime(3) format.
+               If {FMT} is omitted, use %c.
+  %{N}*     -  Pad output with spaces to the Nth column, or to the 
+               current screen width, if {N} is not given.
+  %c        -  A shortcut for "%{%Y-%m-%d %H:%M:%S}t: %ds, %{read,wrote}T%*\r"
+
+* New option --one-top-level
+
+The option --one-top-level tells tar to extract all files into a
+subdirectory named by the base name of the archive (minus standard
+compression suffixes recognizable by --auto-compress).  When used with
+an argument, as in --one-top-level=DIR, the files are extracted into the
+supplied DIRectory.  This ensures that no archive members are
+extracted outside of the specified directory, even if the archive is
+crafted so as to put them elsewhere.

 
 * Manpages
 
 
 * Manpages
 


@@ -1466,7 +1476,7 @@ Versions 1.07 back to 1.00 by Jay Fenlason.
 
 \f
 
 
 \f
 

-Copyright 1994-2001, 2003-2010, 2013 Free Software Foundation, Inc.
+Copyright 1994-2001, 2003-2010, 2013-2014 Free Software Foundation, Inc.

 
 This file is part of GNU tar.
 
 
 This file is part of GNU tar.