@c This is part of the paxutils manual.
-@c Copyright (C) 2006 Free Software Foundation, Inc.
+@c Copyright (C) 2006, 2007 Free Software Foundation, Inc.
@c Written by Sergey Poznyakoff
@c This file is distributed under GFDL 1.1 or any later version
@c published by the Free Software Foundation.
@noindent
where @var{C} is one of the @dfn{control codes} described below,
@var{filename} is the name of the file @var{C} operates upon, and
-@samp{\0} represents a nul character (ASCII 0). The white space
+@samp{\0} represents a nul character (ASCII 0). The white space
characters were added for readability, real dumpdirs do not contain
them.
@item R
This code requests renaming of the @var{filename} to the name
-specified with the following @samp{T} command.
+specified with the @samp{T} command, that immediately follows it.
@item T
Specify target file name for @samp{R} command (see below).
@enumerate 1
@item
Previous run dumped a directory @file{foo} which contained the
-following three directories:
+following three directories:
@smallexample
a
@end enumerate
This case cannot be handled by three successive renames, since
-renaming @file{a} to @file{b} will destroy existing directory.
-To handle such case a temporary directory is required. @GNUTAR{}
-will create the following dumpdir (newlines have been added for
-readability):
+renaming @file{a} to @file{b} will destroy the existing directory.
+To correctly process it, @GNUTAR{} needs a temporary directory, so
+it creates the following dumpdir (newlines have been added for
+readability):
@smallexample
@group
tells tar to rename the temporary directory to @file{foo/a}.
The exact placement of a dumpdir in the archive depends on the
-archive format (@pxref{Formats}):
+archive format (@pxref{Formats}):
@itemize
@item PAX archives