Bugfix

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index 50e5f4ed83b8b83f9fd752ab149f577be8fd8b00..ea3a27d22b81abe4e572168fcb719b2851f56a84 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-10

 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