X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Ftar;a=blobdiff_plain;f=doc%2Fdumpdir.texi;h=76af48e8c900564c7bd5f7bd7722969eeca744d9;hp=ab917c0b787c6eda7fd010b79255d84b1e87739c;hb=45ccda119355a1087450039a250359c1d0de0d08;hpb=018de583736a72435dfed331383a236830a08d04 diff --git a/doc/dumpdir.texi b/doc/dumpdir.texi index ab917c0..76af48e 100644 --- a/doc/dumpdir.texi +++ b/doc/dumpdir.texi @@ -1,5 +1,5 @@ @c This is part of the paxutils manual. -@c Copyright (C) 2006 Free Software Foundation, Inc. +@c Copyright (C) 2006-2007, 2014 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. @@ -16,7 +16,7 @@ dumped directory in special data blocks called @dfn{dumpdirs}. @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. @@ -38,7 +38,7 @@ changed since the last backup. @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). @@ -68,7 +68,7 @@ directory}. For example, consider the following scenario: @enumerate 1 @item Previous run dumped a directory @file{foo} which contained the -following three directories: +following three directories: @smallexample a @@ -90,10 +90,10 @@ New incremental dump was made. @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 @@ -114,7 +114,7 @@ work as usual, and, finally, the last command, @samp{R\0Tfoo/a\0} 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 @@ -125,7 +125,7 @@ corresponding directory, in variable @code{GNU.dumpdir}. @item GNU and old GNU archives These formats implement special header type @samp{D}, which is similar -to ustar header @samp{5} (directory), except that it preceeds a data +to ustar header @samp{5} (directory), except that it precedes a data block containing the dumpdir. @end itemize