Fix a typo and some wordings in the documentation.

[chaz/tar] / NEWS

diff --git a/NEWS b/NEWS
index 44b2e37081343107aaa3a1090ae3e2bbed1c24e0..3f63ed79a850d954cd454b1f283f3b7cfc48253a 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-03-27

 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,54 @@ 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.
+
+* New option --sort
+
+The --sort=ORDER option instructs tar to sort directory entries
+according to ORDER.  It takes effect when creating archives.
+Available ORDERs are: none (the default), name and inode.  The
+latter may be absent, if the underlying system does not provide
+the necessary information.
+
+Using --sort=name ensures the member ordering in the created archive
+is uniform and reproducible.  Using --sort=inode reduces the number
+of disk seeks made when creating the archive and thus can considerably
+speed up archivation.
+
+* New exclusion options
+
+  --exclude-ignore=FILE   Before dumping a directory check if it
+                          contains FILE, and if so read exclude
+                          patterns for this directory from FILE.
+  --exclude-ignore-recursive=FILE
+                          Same as above, but the exclusion patterns
+                          read from FILE remain in effect for any
+                         subdirectory, recursively.
+  --exclude-vcs-ignores   Read exclude tags from VCS ignore files,
+                          where such files exist.  Supported VCS's
+                          are: CVS, Git, Bazaar, Mercurial.
+                         
+
+* Tar refuses to read input from and write output to a tty device.

 
 * Manpages
 
 
 * Manpages
 


@@ -42,14 +81,6 @@ 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
 


@@ -1474,7 +1505,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.