Fix docs.

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index ced28e07825aea0b6c435248efde39b87bb413ec..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
 


@@ -42,6 +52,14 @@ version 1.27.1 - Sergey Poznyakoff, 2013-11-17
 
 * Fix extracting sparse members from star archives.
 
 
 * 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
 
 \f
 version 1.27 - Sergey Poznyakoff, 2013-10-05
 


@@ -1466,7 +1484,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.