File: sparse.adoc

package info (click to toggle)
git 1%3A2.50.1-0.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 61,696 kB
  • sloc: ansic: 302,907; sh: 260,696; perl: 27,874; tcl: 22,303; makefile: 4,280; python: 3,442; javascript: 772; csh: 45; lisp: 12
file content (27 lines) | stat: -rw-r--r-- 1,291 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
sparse.expectFilesOutsideOfPatterns::
	Typically with sparse checkouts, files not matching any
	sparsity patterns are marked with a SKIP_WORKTREE bit in the
	index and are missing from the working tree.  Accordingly, Git
	will ordinarily check whether files with the SKIP_WORKTREE bit
	are in fact present in the working tree contrary to
	expectations.  If Git finds any, it marks those paths as
	present by clearing the relevant SKIP_WORKTREE bits.  This
	option can be used to tell Git that such
	present-despite-skipped files are expected and to stop
	checking for them.
+
The default is `false`, which allows Git to automatically recover
from the list of files in the index and working tree falling out of
sync.
+
Set this to `true` if you are in a setup where some external factor
relieves Git of the responsibility for maintaining the consistency
between the presence of working tree files and sparsity patterns.  For
example, if you have a Git-aware virtual file system that has a robust
mechanism for keeping the working tree and the sparsity patterns up to
date based on access patterns.
+
Regardless of this setting, Git does not check for
present-despite-skipped files unless sparse checkout is enabled, so
this config option has no effect unless `core.sparseCheckout` is
`true`.