Skip to content

Commit 8d0d81a

Browse files
dschogitster
authored andcommitted
technical/shallow: stop referring to grafts
Now that grafts are deprecated, we should start to assume that readers have no idea what grafts are. So it makes more sense to make the description of the "shallow" feature stand on its own. Suggested-by: Eric Sunshine <[email protected]> Helped-by: Junio Hamano <[email protected]> Signed-off-by: Johannes Schindelin <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent e2d65c1 commit 8d0d81a

File tree

1 file changed

+4
-9
lines changed

1 file changed

+4
-9
lines changed

Documentation/technical/shallow.txt

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,10 @@ repo, and therefore grafts are introduced pretending that
88
these commits have no parents.
99
*********************************************************
1010

11-
The basic idea is to write the SHA-1s of shallow commits into
12-
$GIT_DIR/shallow, and handle its contents like the contents
13-
of $GIT_DIR/info/grafts (with the difference that shallow
14-
cannot contain parent information).
15-
16-
This information is stored in a new file instead of grafts, or
17-
even the config, since the user should not touch that file
18-
at all (even throughout development of the shallow clone, it
19-
was never manually edited!).
11+
$GIT_DIR/shallow lists commit object names and tells Git to
12+
pretend as if they are root commits (e.g. "git log" traversal
13+
stops after showing them; "git fsck" does not complain saying
14+
the commits listed on their "parent" lines do not exist).
2015

2116
Each line contains exactly one SHA-1. When read, a commit_graft
2217
will be constructed, which has nr_parent < 0 to make it easier

0 commit comments

Comments
 (0)