From: Sergey Poznyakoff <gray@gnu.org.ua>
Date: Wed, 26 Sep 2007 22:06:24 +0000 (+0000)
Subject: Update
X-Git-Url: https://git.brokenzipper.com/gitweb?a=commitdiff_plain;h=8940247418a040fd261a94c72802d12f6832bc62;p=chaz%2Ftar

Update
---

diff --git a/NEWS b/NEWS
index 4a3a2a2..541fa4d 100644
--- a/NEWS
+++ b/NEWS
@@ -1,9 +1,24 @@
-GNU tar NEWS - User visible changes. 2007-08-24
+GNU tar NEWS - User visible changes. 2007-09-26
 Please send GNU tar bug reports to <bug-tar@gnu.org>
 
 
 version 1.18.1 (CVS)
 
+* New option --exclude-vcs
+
+Excludes directories and files, internal to some widely used version
+control systems, e.g. "CVS/", ".svn/", etc.
+
+* --exclude-tag and --exclude-cache options
+
+The following options now work with incremental archives as well:
+
+  --exclude-caches       
+  --exclude-caches-all   
+  --exclude-tag
+  --exclude-tag-all
+  --exclude-tag-under
+
 * Fix --version output.
 
 * Recognition of broken archive.
diff --git a/doc/tar.texi b/doc/tar.texi
index c38e3e6..419999a 100644
--- a/doc/tar.texi
+++ b/doc/tar.texi
@@ -2540,6 +2540,14 @@ named @var{file}, but dump the directory node itself.  @xref{exclude}.
 Exclude from dump any directory containing file named @var{file}.
 @xref{exclude}. 
 
+@opsummary{exclude-vcs}
+@item --exclude-vcs
+
+Exclude from dump directories and files, that are internal for some
+widely used version control systems.
+
+@xref{exclude}.
+
 @opsummary{file}
 @item --file=@var{archive}
 @itemx -f @var{archive}
@@ -6506,6 +6514,42 @@ called as @w{@samp{tar -c -X foo .}} and the file @file{foo} contains a
 single line @file{*.o}, no files whose names end in @file{.o} will be
 added to the archive.
 
+Notice, that lines from @var{file} are read verbatim. One of the
+frequent errors is leaving some extra whitespace after a file name,
+which is difficult to catch using text editors.
+
+However, empty lines are OK.
+
+@cindex version control system, excluding files
+@cindex VCS, excluding files
+@cindex SCCS, excluding files
+@cindex RCS, excluding files
+@cindex CVS, excluding files
+@cindex SVN, excluding files
+@cindex git, excluding files
+@table @option
+@opindex exclude-vcs
+@item --exclude-vcs
+Exclude files and directories used by some version control systems.
+@end table
+
+As of version @value{VERSION}, the following files are excluded:
+
+@itemize @bullet
+@item @file{CVS/}, and everything under it
+@item @file{RCS/}, and everything under it
+@item @file{SCCS/}, and everything under it
+@item @file{.git/}, and everything under it
+@item @file{.gitignore}
+@item @file{.cvsignore}
+@item @file{.svn/}, and everything under it
+@item @file{.arch-ids/}, and everything under it
+@item @file{@{arch@}/}, and everything under it
+@item @file{=RELEASE-ID}
+@item @file{=meta-update}
+@item @file{=update}
+@end itemize
+
 @findex exclude-caches
 When creating an archive, the @option{--exclude-caches} option family
 causes @command{tar} to exclude all directories that contain a @dfn{cache
@@ -6516,7 +6560,7 @@ Various applications write cache directory tags into directories they
 use to hold regenerable, non-precious data, so that such data can be
 more easily excluded from backups.
 
-There are three @samp{exclude-caches} option, providing a different
+There are three @samp{exclude-caches} options, each providing a different
 exclusion semantics:
 
 @table @option