mirrors/tar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document changes to the --transform option.

Browse Source
This commit is contained in:
Sergey Poznyakoff
2008-02-04 10:38:18 +00:00
parent 338591a486
commit e08afc2002
2 changed files with 26 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
NEWS
View File

@@ -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> 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 options can be specified, the actions will be executed in order of
their appearance in the command line. 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 * Info (end-of-volume) scripts
The value of the blocking factor is made available to info and The value of the blocking factor is made available to info and

19
doc/tar.texi
View File

@@ -35,7 +35,7 @@ This manual is for @acronym{GNU} @command{tar} (version
from archives. from archives.
Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 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 @quotation
Permission is granted to copy, distribute and/or modify this document 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 @smallexample
tar (GNU tar) @value{VERSION} 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 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>. of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
There is NO WARRANTY, to the extent permitted by law. 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 @var{regexp} and @var{replace} are described in detail in
@ref{The "s" Command, The "s" Command, The `s' Command, sed, GNU sed}. @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: Supported @var{flags} are:
@table @samp @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 together, then @option{--transform} is applied first, and the required
number of components is then stripped from its result. 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 @node after
@section Operating Only on New Files @section Operating Only on New Files
@UNREVISED @UNREVISED