From: Sergey Poznyakoff Date: Sat, 5 Nov 2005 16:49:17 +0000 (+0000) Subject: Update X-Git-Url: https://git.dogcows.com/gitweb?a=commitdiff_plain;h=8b2504deca784ca4175c31e2a68c6ecea7c2ffcb;p=chaz%2Ftar Update --- diff --git a/doc/Makefile.am b/doc/Makefile.am index 5bcb665..57bbfc5 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -18,7 +18,15 @@ ## Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. info_TEXINFOS = tar.texi -tar_TEXINFOS = fdl.texi freemanuals.texi getdate.texi header.texi rendition.texi value.texi genfile.texi +tar_TEXINFOS = \ + fdl.texi\ + freemanuals.texi\ + genfile.texi\ + getdate.texi\ + header.texi\ + rendition.texi\ + snapshot.texi\ + value.texi EXTRA_DIST = convtexi.pl gendocs_template DISTCLEANFILES=*.info* diff --git a/doc/tar.texi b/doc/tar.texi index 2798e63..0340802 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -98,6 +98,7 @@ document. The rest of the menu lists all the lower level nodes. Appendices * Genfile:: +* Snapshot Files:: * Free Software Needs Free Documentation:: * Copying This Manual:: * Index:: @@ -340,9 +341,10 @@ Using Multiple Tapes * Multi-Volume Archives:: Archives Longer than One Tape or Disk * Tape Files:: Tape Files -GNU tar test suite +GNU tar internals and development * Genfile:: +* Snapshot Files:: Copying This Manual @@ -2400,7 +2402,8 @@ archive, which normally signals EOF. @xref{Reading}. Used to inform @command{tar} that it is working with an old @acronym{GNU}-format incremental backup archive. It is intended -primarily for backwards compatibility only. @FIXME-xref{} +primarily for backwards compatibility only. @FIXME{incremental and +listed-incremental}. @item --index-file=@var{file} @@ -2448,7 +2451,7 @@ During a @option{--create} operation, specifies that the archive that @command{tar} creates is a new @acronym{GNU}-format incremental backup, using @var{snapshot-file} to determine which files to backup. With other operations, informs @command{tar} that the archive is in -incremental format. @FIXME-xref{} +incremental format. @FIXME{incremental and listed-incremental}. @item --mode=@var{permissions} @@ -4833,16 +4836,17 @@ the file system to that which obtained when the backup was made. If @value{op-incremental} isn't specified, the file system will probably fill up with files that shouldn't exist any more. -@value{op-incremental} in conjunction with @value{op-list} causes -@command{tar} to print, for each directory in the archive, the list of -files in that directory at the time the archive was created. This -information is put out in a format that is not easy for humans to -read, but which is unambiguous for a program: each file name is -preceded by either a @samp{Y} if the file is present in the archive, -an @samp{N} if the file is not included in the archive, or a @samp{D} -if the file is a directory (and is included in the archive). Each -file name is terminated by a null character. The last file is followed -by an additional null and a newline to indicate the end of the data. +@value{op-incremental} in conjunction with @value{op-list} and two +@value{op-verbose} options causes @command{tar} to print, for each +directory in the archive, the list of files in that directory at the +time the archive was created. This information is put out in a format +that is not easy for humans to read, but which is unambiguous for a +program: each file name is preceded by either a @samp{Y} if the file +is present in the archive, an @samp{N} if the file is not included in +the archive, or a @samp{D} if the file is a directory (and is included +in the archive). Each file name is terminated by a newline character. +The last file is followed by an additional newline to +indicate the end of the data. @value{op-listed-incremental} acts like @value{op-incremental}, but when used in conjunction with @value{op-create} will also cause @command{tar} @@ -4859,7 +4863,7 @@ directory names. @command{tar} will archive files with newer mod dates or inode change times, and directories with an unchanged inode number and device but a changed directory name. The file is updated after the files to be archived are determined, but before the new archive is -actually created. +actually created.@FIXME-xref{to the description of the file format}. Incremental dumps depend crucially on time stamps, so the results are unreliable if you modify a file's time stamps during dumping (e.g., @@ -8903,6 +8907,10 @@ changeable feature. @appendix Genfile @include genfile.texi +@node Snapshot Files +@appendix Format of the Incremental Snapshot Files +@include snapshot.texi + @node Copying This Manual @appendix Copying This Manual