Update docs.

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index 50e5f4ed83b8b83f9fd752ab149f577be8fd8b00..481ea271ce623143cf04520f76af8ddcb25d1d00 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
@@ -25,6 +25,16 @@ sign and the specifier letter.
               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
 
 This release includes official tar(1) and rmt(8) manpages.