X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=doc%2Ftar.texi;h=980f758027c49ebee94669e56aa8aebc6d2d1845;hb=9dfffffa8417992e3d5db303fadba7d392b7c0ff;hp=68bb0910b6e960f78ea579b10075ad85c3bbebc0;hpb=093b8189300dcbdb8a7cd836a2986199664f3c89;p=chaz%2Ftar

diff --git a/doc/tar.texi b/doc/tar.texi
index 68bb091..980f758 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{-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 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{bug-tar@@gnu.org}.
 
 @node Tutorial, tar invocation, Introduction, Top
 @chapter Tutorial Introduction to @code{tar}
@@ -1089,7 +1094,7 @@ device, such as a tape drive.  However, some of the later examples in
 the tutorial and next chapter will not work on tape drives.
 Additionally, working with tapes is much more complicated than working
 with hard disks.  For these reasons, the tutorial does not cover working
-with tape drives.  @xref{Media} for complete information on using
+with tape drives.  @xref{Media}, for complete information on using
 @code{tar} archives with tape drives.
 
 @FIXME{this is a cop out.  need to add some simple tape drive info.}
@@ -1426,7 +1431,7 @@ short forms.  With short forms, if you type commands in the wrong order
 (even if you type them correctly in all other ways), you may end up with
 results you don't expect.  For this reason, it is a good idea to get
 into the habit of typing options in the order that makes inherent sense.
-@xref{short create} for more information on this.
+@xref{short create}, for more information on this.
 
 In this example, you type the command as shown above: @samp{--create}
 is the operation which creates the new archive
@@ -2513,6 +2518,12 @@ 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 --bzip2
+@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
@@ -3069,6 +3080,10 @@ them with the equivalent long option.
 
 @samp{--extract}
 
+@item -y
+
+@samp{--bzip2}
+
 @item -z
 
 @samp{--gzip}
@@ -3640,7 +3655,7 @@ The newest version of @file{blues} is now at the end of the archive
 (note the different creation dates and file sizes).  If you extract
 the archive, the older version of the file @file{blues} will be
 overwritten by the newer version.  You can confirm this by extracting
-the archive and running @samp{ls} on the directory.  @xref{Writing}
+the archive and running @samp{ls} on the directory.  @xref{Writing},
 for more information.  (@emph{Please note:} This is the case unless
 you employ the @value{op-backup} option; @FIXME-ref{Multiple Members
 with the Same Name}.)
@@ -3710,7 +3725,7 @@ updating it.
 
 (The reason @code{tar} does not overwrite the older file when updating
 it is because writing to the middle of a section of tape is a difficult
-process.  Tapes are not designed to go backward.  @xref{Media} for more
+process.  Tapes are not designed to go backward.  @xref{Media}, for more
 information about tapes.
 
 @value{op-update} is not suitable for performing backups for two
@@ -3804,7 +3819,7 @@ from the target archive before each new archive is appended.  If you use
 @code{cat} to combine the archives, the result will not be a valid
 @code{tar} format archive.  If you need to retrieve files from an
 archive that was added to using the @code{cat} utility, use the
-@value{op-ignore-zeros} option.  @xref{Ignore Zeros} for further
+@value{op-ignore-zeros} option.  @xref{Ignore Zeros}, for further
 information on dealing with archives improperly combined using the
 @code{cat} shell utility.
 
@@ -5337,9 +5352,17 @@ The @value{op-exclude} option will prevent any file or member which
 matches the shell wildcards (@var{pattern}) from being operated on
 (@var{pattern} can be a single file name or a more complex expression).
 For example, if you want to create an archive with all the contents of
-@file{/tmp} except the file @file{/tmp/foo}, you can use the command
-@samp{tar --create --file=arch.tar --exclude=foo}.  You may give
-multiple @samp{--exclude} options.
+the working directory except for files whose names end in @file{.o}, you
+can use the command @samp{tar -cf arch.tar --exclude='*.o' .}.
+
+A @var{pattern} containing @samp{/} excludes a file if an initial prefix
+of the file name matches @var{pattern}; a @var{pattern} without @samp{/}
+excludes a file if it matches any of its file name components.  For
+example, the pattern @samp{b*/RCS} excludes @file{blob/RCS} and
+@file{blob/RCS/f} but not @file{a/blob/RCS} or @file{blob/sub/RCS},
+whereas the pattern @samp{RCS} excludes all these file names.
+
+You may give multiple @samp{--exclude} options.
 
 @table @kbd
 @item --exclude-from=@var{file}
@@ -5378,12 +5401,12 @@ pitfalls:
 
 @itemize @bullet
 @item
-The main operating mode of @code{tar} will always act on file names
-listed on the command line, no matter whether or not there is an
-exclusion which would otherwise affect them.  In the example above, if
+The main operating mode of @code{tar} does not act on a path name
+explicitly listed on the command line if one of its file name
+components is excluded.  In the example above, if
 you create an archive and exclude files that end with @samp{*.o}, but
-explicitly name the file @samp{catc.o} after all the options have been
-listed, @samp{catc.o} @emph{will} be included in the archive.
+explicitly name the file @samp{dir.o/foo} after all the options have been
+listed, @samp{dir.o/foo} will be excluded from the archive.
 
 @item
 You can sometimes confuse the meanings of @value{op-exclude} and
@@ -5404,14 +5427,14 @@ illegal.  This might not correspond to what you want.
 For example, write:
 
 @example
-$ @kbd{tar -c -f @var{archive.tar} -X '*/tmp/*' @var{directory}}
+$ @kbd{tar -c -f @var{archive.tar} --exclude '*.o' @var{directory}}
 @end example
 
 @noindent
 rather than:
 
 @example
-$ @kbd{tar -c -f @var{archive.tar} -X */tmp/* @var{directory}}
+$ @kbd{tar -c -f @var{archive.tar} --exclude *.o @var{directory}}
 @end example
 
 @item
@@ -6036,6 +6059,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 +6770,10 @@ 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
+Filter the archive through @code{bzip2}.  Otherwise like @value{op-gzip}.
+
 @item -Z
 @itemx --compress
 @itemx --uncompress
@@ -6776,6 +6806,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