Add --bzip2, --bunzip2 options.

[chaz/tar] / doc / tar.texi

diff --git a/doc/tar.texi b/doc/tar.texi
index 68bb0910b6e960f78ea579b10075ad85c3bbebc0..a7e025e0ac5e219ba608608fd8271542b827c0ac 100644 (file)
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -131,6 +131,11 @@
 @set xref-blocking-factor @xref{Blocking Factor}
 @set pxref-blocking-factor @pxref{Blocking Factor}
 
+@set op-bzip2 @kbd{--bzip2} (@kbd{--bunzip2}, @kbd{-y})
+@set ref-bzip2 @ref{gzip}
+@set xref-bzip2 @xref{gzip}
+@set pxref-bzip2 @pxref{gzip}
+
 @set op-checkpoint @kbd{--checkpoint}
 @set ref-checkpoint @ref{verbose}
 @set xref-checkpoint @xref{verbose}
@@ -459,7 +464,7 @@ END-INFO-DIR-ENTRY
 This file documents GNU @code{tar}, a utility used to store, backup, and
 transport files.
 
-Copyright (C) 1992, 1994, 1995, 1996, 1997 Free Software Foundation, Inc.
+Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -497,7 +502,7 @@ by the Foundation.
 
 @page
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1992, 1994, 1995, 1996, 1997 Free Software
+Copyright @copyright{} 1992, 1994, 1995, 1996, 1997, 1999 Free Software
 Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
@@ -2513,6 +2518,18 @@ with the block number in the archive file.  @FIXME-xref{}.
 Sets the blocking factor @code{tar} uses to @var{blocking} x 512 bytes per
 record.  @FIXME-xref{}.
 
+@item --bunzip2
+
+(See @samp{--bzip2}; @FIXME-pxref{}.)
+
+@item --bzip2
+@itemx --bunzip2
+@itemx --unbzip2
+@itemx -y
+
+This option tells @code{tar} to read or write archives through @code{bzip2}.
+@FIXME-xref{}.
+
 @item --checkpoint
 
 This option directs @code{tar} to print periodic checkpoint messages as it
@@ -2865,6 +2882,10 @@ Sets the modification time of extracted files to the extraction time,
 rather than the modification time stored in the archive.
 @xref{Writing}.
 
+@item --unbzip2
+
+(See @samp{--bzip2}; @FIXME-pxref{}.)
+
 @item --uncompress
 
 (See @samp{--compress}; @FIXME-pxref{}.)
@@ -3069,6 +3090,10 @@ them with the equivalent long option.
 
 @samp{--extract}
 
+@item -y
+
+@samp{--bzip2}
+
 @item -z
 
 @samp{--gzip}
@@ -6036,6 +6061,9 @@ or @samp{p.m.}), @var{hour} is restricted to run from 1 to 12, and
 indicates the first half of the day, @samp{pm} indicates the second
 half of the day.  In this notation, 12 is the predecessor of 1:
 midnight is @samp{12am} while noon is @samp{12pm}.
+(This is the zero-oriented interpretation of @samp{12am} and @samp{12pm},
+as opposed to the old tradition derived from Latin
+which uses @samp{12m} for noon and @samp{12pm} for midnight.)
 
 @cindex timezone correction
 @cindex minutes, timezone correction by
@@ -6744,6 +6772,11 @@ loose some compressibility.  But this would have make recovering easier.
 So, there are pros and cons.  We'll see!
 
 @table @kbd
+@item -y
+@itemx --bzip2
+@itemx --unbzip2
+Filter the archive through @code{bzip2}.  Otherwise like @value{op-gzip}.
+
 @item -Z
 @itemx --compress
 @itemx --uncompress
@@ -6776,6 +6809,9 @@ If there is no compress utility available, @code{tar} will report an error.
 @strong{Please note} that the @code{compress} program may be covered by
 a patent, and therefore we recommend you stop using it.
 
+@value{op-bzip2} acts like @value{op-compress}, except that it uses
+the @code{bzip2} utility.
+
 @table @kbd
 @item --compress
 @itemx --uncompress