Document changes to the --transform option.

2 files changed, 26 insertions, 3 deletions

diff --git a/NEWS b/NEWS
index cd71d024..90ad8045 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-GNU tar NEWS - User visible changes. 2007-12-05
+GNU tar NEWS - User visible changes. 2008-02-04
 Please send GNU tar bug reports to <bug-tar@gnu.org>
 
 
@@ -26,6 +26,14 @@ echo=string, and sleep=value.  Any number of `--checkpoint-action'
 options can be specified, the actions will be executed in order of
 their appearance in the command line.  
 
+* The --transform option.
+
+Any number of `--transform' options can be given in the command line.
+The specified transformations will be applied in turn.
+
+The argument to `--transform' option can be a list of replace
+expressions, separated by a semicolon (as in `sed').
+
 * Info (end-of-volume) scripts
 
 The value of the blocking factor is made available to info and
diff --git a/doc/tar.texi b/doc/tar.texi
index 1eb2fc2d..0425107e 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -35,7 +35,7 @@ This manual is for @acronym{GNU} @command{tar} (version
 from archives.
 
 Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001,
-2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
+2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -3440,7 +3440,7 @@ successfully.  For example, @w{@samp{tar --version}} might print:
 
 @smallexample
 tar (GNU tar) @value{VERSION}
-Copyright (C) 2006 Free Software Foundation, Inc.
+Copyright (C) 2008 Free Software Foundation, Inc.
 This is free software.  You may redistribute copies of it under the terms
 of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 There is NO WARRANTY, to the extent permitted by law.
@@ -7565,6 +7565,9 @@ replacement for each file name part that matches @var{regexp}.  Both
 @var{regexp} and @var{replace} are described in detail in
 @ref{The "s" Command, The "s" Command, The `s' Command, sed, GNU sed}.
 
+As in @command{sed}, you can give several replace expressions,
+separated by a semicolon.
+
 Supported @var{flags} are:
 
 @table @samp
@@ -7658,6 +7661,18 @@ If both @option{--strip-components} and @option{--transform} are used
 together, then @option{--transform} is applied first, and the required
 number of components is then stripped from its result.
 
+You can use as many @option{--transform} options in a single command
+line as you want.  The specified expressions will then be applied in
+order of their appearance.  For example, the following two invocations
+are equivalent:
+
+@smallexample
+$ @kbd{tar -cf arch.tar --transform='s,/usr/var,/var/' \
+                        --transform='s,/usr/local,/usr/,'}
+$ @kbd{tar -cf arch.tar \
+               --transform='s,/usr/var,/var/;s,/usr/local,/usr/,'}
+@end smallexample
+
 @node after
 @section Operating Only on New Files
 @UNREVISED