X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Fdumpdir.texi;h=7af3ba7cced4880fa0c917e7bcaf9b025cb5a944;hb=a09e840507c16357ec11b17a02e103c3a26adebc;hp=73b173687195284ef8b34a9e3d34cc3bc88be41e;hpb=5addfdcb03a710d220d0d38262b106b99268b2ec;p=chaz%2Ftar diff --git a/doc/dumpdir.texi b/doc/dumpdir.texi index 73b1736..7af3ba7 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 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