From 8940247418a040fd261a94c72802d12f6832bc62 Mon Sep 17 00:00:00 2001 From: Sergey Poznyakoff Date: Wed, 26 Sep 2007 22:06:24 +0000 Subject: [PATCH] Update --- NEWS | 17 ++++++++++++++++- doc/tar.texi | 46 +++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 61 insertions(+), 2 deletions(-) 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 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 -- 2.45.2