Initial revision

[chaz/tar] / doc / tar.texi

diff --git a/doc/tar.texi b/doc/tar.texi
index 5706e95f7d1dd1d4f2b5c1c36b82ae9c411b0bb9..4a605e556b82a30017b0e4f82683f619582a0774 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
@@ -1022,7 +1027,7 @@ consulting.  In particular, he is the primary author of @ref{Backups}.
 @cindex bug reports
 @cindex reporting bugs
 If you find problems or have suggestions about this program or manual,
-please report them to @file{bug-gnu-utils@@prep.ai.mit.edu}.
+please report them to @file{tar-bugs@@gnu.org}.
 
 @node Tutorial, tar invocation, Introduction, Top
 @chapter Tutorial Introduction to @code{tar}
@@ -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}
@@ -6747,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
@@ -6779,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