From dcf34d8c4a0504fdc8f3df148d2d5c86e0e88522 Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sat, 20 Feb 1999 06:04:28 +0000
Subject: [PATCH] Add --bzip2, --bunzip2 options.

---
 doc/tar.texi | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/doc/tar.texi b/doc/tar.texi
index 5706e95..a7e025e 100644
--- 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}
@@ -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
-- 
2.44.0