← Back to branch summary

~ubuntu-branches/debian/sid/git/sid

« back to all changes in this revision

Viewing changes to Documentation/technical/shallow.txt

  • Committer: Package Import Robot
  • Author(s): Jonathan Nieder
  • Date: 2013-06-12 07:50:53 UTC
  • mfrom: (1.2.19) (2.1.31 experimental)
  • Revision ID: package-import@ubuntu.com-20130612075053-uue9xe0dq0rvm44y
Tags: 1:1.8.3.1-1
* merge branch debian-experimental
* new upstream point release (see RelNotes/1.8.3.1.txt).
* debian/watch: use xz-compressed tarballs from kernel.org.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/technical/shallow.txt
1
 
Def.: Shallow commits do have parents, but not in the shallow
 
1
Shallow commits
 
2
===============
 
3
 
 
4
.Definition
 
5
*********************************************************
 
6
Shallow commits do have parents, but not in the shallow
2
7
repo, and therefore grafts are introduced pretending that
3
8
these commits have no parents.
 
9
*********************************************************
4
10
 
5
 
The basic idea is to write the SHA1s of shallow commits into
 
11
The basic idea is to write the SHA-1s of shallow commits into
6
12
$GIT_DIR/shallow, and handle its contents like the contents
7
13
of $GIT_DIR/info/grafts (with the difference that shallow
8
14
cannot contain parent information).
12
18
at all (even throughout development of the shallow clone, it
13
19
was never manually edited!).
14
20
 
15
 
Each line contains exactly one SHA1. When read, a commit_graft
 
21
Each line contains exactly one SHA-1. When read, a commit_graft
16
22
will be constructed, which has nr_parent < 0 to make it easier
17
23
to discern from user provided grafts.
18
24
 
47
53
You can deepen a shallow repository with "git-fetch --depth 20
48
54
repo branch", which will fetch branch from repo, but stop at depth
49
55
20, updating $GIT_DIR/shallow.
 
56
 
 
57
The special depth 2147483647 (or 0x7fffffff, the largest positive
 
58
number a signed 32-bit integer can contain) means infinite depth.