Update

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 5bcb6651ee5345c73ccbca6b0d8318e906b108c2..57bbfc541b11779a2039940d8543d8f105e083b6 100644 (file)
--- 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
 ## 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* 
 
 EXTRA_DIST = convtexi.pl gendocs_template 
 DISTCLEANFILES=*.info* 
 

diff --git a/doc/tar.texi b/doc/tar.texi
index 2798e63c1e75ef96120e58b965099b92448be285..0340802f0e8b3d7090e7cadea43867d0e4b60c6b 100644 (file)
--- 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::
 Appendices
 
 * Genfile::

+* Snapshot Files::

 * Free Software Needs Free Documentation::
 * Copying This Manual::
 * Index::
 * 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
 
 * Multi-Volume Archives::       Archives Longer than One Tape or Disk
 * Tape Files::                  Tape Files
 

-GNU tar test suite
+GNU tar internals and development

 
 * Genfile::
 
 * Genfile::

+* Snapshot Files::

 
 Copying This Manual
 
 
 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
 
 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}
 
 
 @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
 @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}
 
 
 @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} 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}
 
 @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
 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.,
 
 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
 
 @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
 
 @node Copying This Manual
 @appendix Copying This Manual