X-Git-Url: https://git.brokenzipper.com/gitweb?a=blobdiff_plain;f=doc%2Ftar.texi;h=e3ad08f0bd33d78c7fd7b92fcbc517e96994868d;hb=277f69debfb05ed3417483fc21be0f62a14ac81a;hp=e430e58b722705540862559f0b67273b9bc9e7a5;hpb=bf78c421f0dee5fbf91b7527db6f6f663ea5c9fd;p=chaz%2Ftar diff --git a/doc/tar.texi b/doc/tar.texi index e430e58..e3ad08f 100644 --- a/doc/tar.texi +++ b/doc/tar.texi @@ -1022,7 +1022,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{tar-bugs@@gnu.org}. +please report them to @file{bug-tar@@gnu.org}. @node Tutorial, tar invocation, Introduction, Top @chapter Tutorial Introduction to @code{tar} @@ -5338,8 +5338,9 @@ 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. +@samp{tar --create --file=arch.tar --exclude=foo}. A path name is +excluded if any of its file name components matches @var{pattern}. +You may give multiple @samp{--exclude} options. @table @kbd @item --exclude-from=@var{file} @@ -5378,12 +5379,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