Fix NEWS

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index 50e5f4ed83b8b83f9fd752ab149f577be8fd8b00..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
@@ -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.
 
-  %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.
-  %{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
 
@@ -42,14 +52,6 @@ version 1.27.1 - Sergey Poznyakoff, 2013-11-17
 
 * Fix extracting sparse members from star archives.
 
-* The --one-top-level option.
-
-This new command line option tells tar that the working directory
-(or the one passed to -C) should not be populated with more than one
-name directly under it.  Instead, a newly created subdirectory is
-used whose name is equal to the archive name without the extension.
-For example, foo.tar.gz would be extracted to foo.
-
 \f
 version 1.27 - Sergey Poznyakoff, 2013-10-05