Browse Source

Add -y and --bzip2.
Patterns containing / now exclude only file names whose prefix match.

Paul Eggert 26 years ago
parent
commit
9dfffffa84
1 changed files with 35 additions and 6 deletions
  1. 35 6
      doc/tar.texi

+ 35 - 6
doc/tar.texi

@@ -131,6 +131,11 @@
 @set xref-blocking-factor @xref{Blocking Factor}
 @set xref-blocking-factor @xref{Blocking Factor}
 @set pxref-blocking-factor @pxref{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 op-checkpoint @kbd{--checkpoint}
 @set ref-checkpoint @ref{verbose}
 @set ref-checkpoint @ref{verbose}
 @set xref-checkpoint @xref{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
 This file documents GNU @code{tar}, a utility used to store, backup, and
 transport files.
 transport files.
 
 
-Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999 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
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
 this manual provided the copyright notice and this permission notice
@@ -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
 Sets the blocking factor @code{tar} uses to @var{blocking} x 512 bytes per
 record.  @FIXME-xref{}.
 record.  @FIXME-xref{}.
 
 
+@item --bzip2
+@itemx -y
+
+This option tells @code{tar} to read or write archives through @code{bzip2}.
+@FIXME-xref{}.
+
 @item --checkpoint
 @item --checkpoint
 
 
 This option directs @code{tar} to print periodic checkpoint messages as it
 This option directs @code{tar} to print periodic checkpoint messages as it
@@ -3069,6 +3080,10 @@ them with the equivalent long option.
 
 
 @samp{--extract}
 @samp{--extract}
 
 
+@item -y
+
+@samp{--bzip2}
+
 @item -z
 @item -z
 
 
 @samp{--gzip}
 @samp{--gzip}
@@ -5337,9 +5352,16 @@ The @value{op-exclude} option will prevent any file or member which
 matches the shell wildcards (@var{pattern}) from being operated on
 matches the shell wildcards (@var{pattern}) from being operated on
 (@var{pattern} can be a single file name or a more complex expression).
 (@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
 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}.  A path name is
-excluded if any of its file name components matches @var{pattern}.
+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.
 You may give multiple @samp{--exclude} options.
 
 
 @table @kbd
 @table @kbd
@@ -5405,14 +5427,14 @@ illegal.  This might not correspond to what you want.
 For example, write:
 For example, write:
 
 
 @example
 @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
 @end example
 
 
 @noindent
 @noindent
 rather than:
 rather than:
 
 
 @example
 @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
 @end example
 
 
 @item
 @item
@@ -6748,6 +6770,10 @@ loose some compressibility.  But this would have make recovering easier.
 So, there are pros and cons.  We'll see!
 So, there are pros and cons.  We'll see!
 
 
 @table @kbd
 @table @kbd
+@item -y
+@itemx --bzip2
+Filter the archive through @code{bzip2}.  Otherwise like @value{op-gzip}.
+
 @item -Z
 @item -Z
 @itemx --compress
 @itemx --compress
 @itemx --uncompress
 @itemx --uncompress
@@ -6780,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
 @strong{Please note} that the @code{compress} program may be covered by
 a patent, and therefore we recommend you stop using it.
 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
 @table @kbd
 @item --compress
 @item --compress
 @itemx --uncompress
 @itemx --uncompress