Add @setchapternewpage odd.

Remove -I as an alias for -T, for now.
Add @dircategory.
Update copyright.  Remove "Published by".
Dates beginning with / or . are taken to be file names.

diff --git a/doc/tar.texi b/doc/tar.texi
index 9103505c2e36cfc3eb035dd394c466cd208b3a21..e55e69c20c10cb4ea745dd09474d775633d0cdc8 100644 (file)
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -4,6 +4,7 @@
 @settitle GNU tar
 @finalout
 @smallbook
+@setchapternewpage odd
 @c %**end of header
 
 @c ======================================================================
@@ -196,7 +197,7 @@
 @set xref-file @xref{file}
 @set pxref-file @pxref{file}
 
-@set op-files-from @kbd{--files-from=@var{file-of-names}} (@kbd{-I @var{file-of-names}}, @kbd{-T @var{file-of-names}})
+@set op-files-from @kbd{--files-from=@var{file-of-names}} (@kbd{-T @var{file-of-names}})
 @set ref-files-from @ref{files}
 @set xref-files-from @xref{files}
 @set pxref-files-from @pxref{files}
@@ -462,19 +463,21 @@
 @defindex op
 @syncodeindex op cp
 
-@ifinfo
+@dircategory GNU Packages
+@direntry
+Tar: (tar).                    Making tape (or disk) archives.
+@end direntry
+
+@dircategory Individual utilities
 @direntry
-* tar: (tar).                  Making tape (or disk) archives.
+* tar: (tar)tar invocation.                     Invoking @sc{gnu} @command{tar}
 @end direntry
 
+@ifinfo
 This file documents @sc{gnu} @command{tar}, which creates and extracts
 files from archives.
 
-Published by the Free Software Foundation,
-59 Temple Place - Suite 330,
-Boston, MA 02111-1307, USA
-
-Copyright 1992, 1994, 1995, 1996, 1997, 1999, 2000 Free Software
+Copyright 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001 Free Software
 Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
@@ -487,8 +490,6 @@ Free Documentation License''.
 
 @end ifinfo
 
-@setchapternewpage odd
-
 @shorttitlepage @sc{gnu} @command{tar}
 
 @titlepage
@@ -501,8 +502,8 @@ Free Documentation License''.
 
 @page
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999, 2000 Free Software
-Foundation, Inc.
+Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001
+Free Software Foundation, Inc.
 
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.1
@@ -2587,7 +2588,6 @@ performs operations on, rather than @command{tar}'s compilation dependent
 default.  @FIXME-xref{}
 
 @item --files-from=@var{file}
-@itemx -I @var{file}
 @itemx -T @var{file}
 
 @command{tar} will use the contents of @var{file} as a list of archive members
@@ -2713,11 +2713,13 @@ multi-volume @command{tar} archive.  @FIXME-xref{}
 @itemx -N
 
 When creating an archive, @command{tar} will only add files that have changed
-since @var{date}.  @FIXME-xref{}
+since @var{date}.  If @var{date} begins with @samp{/} or @samp{.}, it
+is taken to be the name of a file whose last-modified time specifies
+the date.  @FIXME-xref{}
 
-@item --newer-mtime
+@item --newer-mtime=@var{date}
 
-In conjunction with @samp{--newer}, @command{tar} will only add files whose
+Like @samp{--newer}, but add only files whose
 contents have changed (as opposed to just @samp{--newer}, which will
 also back up files for which any status information has changed).
 
@@ -2977,10 +2979,6 @@ them with the equivalent long option.
 
 @samp{--incremental}
 
-@item -I
-
-@samp{--files-from}
-
 @item -K
 
 @samp{--starting-file}
@@ -5281,14 +5279,13 @@ the list of files to archive with the @command{find} utility.
 
 @table @kbd
 @item --files-from=@var{file name}
-@itemx -I @var{file name}
 @itemx -T @var{file name}
 Get names to extract or create from file @var{file name}.
 @end table
 
 If you give a single dash as a file name for @samp{--files-from}, (i.e.,
-you specify either @samp{--files-from=-} or @samp{-I -}) or @samp{-T
--}), then the file names are read from standard input.
+you specify either @samp{--files-from=-} or @samp{-T -}), then the file
+names are read from standard input.
 
 Unless you are running @command{tar} with @samp{--create}, you can not use
 both @samp{--files-from=-} and @samp{--file=-} (@samp{-f -}) in the same
@@ -5547,7 +5544,9 @@ Your opinions on the matter are welcome.
 
 The @value{op-after-date} option causes @command{tar} to only work on files
 whose modification or inode-changed times are newer than the @var{date}
-given.  If you use this option when creating or appending to an archive,
+given.  If @var{date} starts with @samp{/} or @samp{.}, it is taken to
+be a file name; the last-modified time of that file is used as the date.
+If you use this option when creating or appending to an archive,
 the archive will only include new files.  If you use @samp{--after-date}
 when extracting an archive, @command{tar} will only extract files newer
 than the @var{date} you specify.
@@ -5570,6 +5569,9 @@ Only store files newer than @var{date}.
 Acts on files only if their modification or inode-changed times are
 later than @var{date}.  Use in conjunction with any operation.
 
+If @var{date} starts with @samp{/} or @samp{.}, it is taken to be a file
+name; the last-modified time of that file is used as the date.
+
 @item --newer-mtime=@var{date}
 Acts like @value{op-after-date}, but only looks at modification times.
 @end table
@@ -5605,17 +5607,6 @@ in renamed directories) are not selected properly by these options.
 @xref{incremental and listed-incremental}.
 @end quotation
 
-To select files newer than the modification time of a file that already
-exists, you can use the @samp{--reference} (@samp{-r}) option of @sc{gnu}
-@command{date}, available in @sc{gnu} shell utilities 1.13 or later.  It returns
-the time stamp of the already-existing file; this time stamp expands to
-become the referent date which @samp{--newer} uses to determine which
-files to archive.  For example, you could say,
-
-@example
-$ @kbd{tar -cf @var{archive.tar} --newer="`date -r @var{file}`" /home}
-@end example
-
 @noindent
 @FIXME{which tells -- need to fill this in!}