Update
This commit is contained in:
46
doc/tar.texi
46
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
|
||||
|
||||
Reference in New Issue
Block a user