diff options
| author | J. Bruce Fields <bfields@citi.umich.edu> | 2007-08-31 02:49:33 (GMT) |
|---|---|---|
| committer | J. Bruce Fields <bfields@citi.umich.edu> | 2007-09-16 02:13:31 (GMT) |
| commit | 971aa71fc695e0b56ffe2172543a126d20b16842 (patch) | |
| tree | 692c6db3647070943f26ed0cfaea9e6f3b44ac7a /Documentation/user-manual.txt | |
| parent | 7c8b5eaf225db0b6b502126fc16f8f6814c38d24 (diff) | |
| download | git-971aa71fc695e0b56ffe2172543a126d20b16842.zip git-971aa71fc695e0b56ffe2172543a126d20b16842.tar.gz git-971aa71fc695e0b56ffe2172543a126d20b16842.tar.bz2 | |
user-manual: adjust section levels in "git internals"
The descriptions of the various object types should all be a subsection
of the "Object Database" section.
I cribbed most of this chapter from the README (now core-intro.txt and
git(7)), because there's stuff in there people need to know and I was
too lazy to rewrite it. The audience isn't quite right, though--the
chapter is a mixture of user- and developer- level documentation that
isn't as appropriate now as it was originally.
So, reserve this chapter for stuff users need to know, and move the
source code introduction into a new "git hacking" chapter where we'll
also move any hacker-only technical details.
Signed-off-by: J. Bruce Fields <bfields@citi.umich.edu>
Diffstat (limited to 'Documentation/user-manual.txt')
| -rw-r--r-- | Documentation/user-manual.txt | 17 |
1 files changed, 12 insertions, 5 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index 35298e6..75f2370 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -2787,7 +2787,7 @@ The object types in some more detail: [[blob-object]] Blob Object ------------ +~~~~~~~~~~~ A "blob" object is nothing but a binary blob of data, and doesn't refer to anything else. There is no signature or any other @@ -2809,7 +2809,7 @@ is run, and its data can be accessed by gitlink:git-cat-file[1]. [[tree-object]] Tree Object ------------ +~~~~~~~~~~~ The next hierarchical object type is the "tree" object. A tree object is a list of mode/name/blob data, sorted by name. Alternatively, the @@ -2851,7 +2851,7 @@ Two trees can be compared with gitlink:git-diff-tree[1]. [[commit-object]] Commit Object -------------- +~~~~~~~~~~~~~ The "commit" object is an object that introduces the notion of history into the picture. In contrast to the other objects, it @@ -2878,7 +2878,7 @@ its data can be accessed by gitlink:git-cat-file[1]. [[trust]] Trust ------ +~~~~~ An aside on the notion of "trust". Trust is really outside the scope of "git", but it's worth noting a few things. First off, since @@ -2908,7 +2908,7 @@ To assist in this, git also provides the tag object... [[tag-object]] Tag Object ----------- +~~~~~~~~~~ Git provides the "tag" object to simplify creating, managing and exchanging symbolic and signed tokens. The "tag" object at its @@ -3474,6 +3474,13 @@ confusing and scary messages, but it won't actually do anything bad. In contrast, running "git prune" while somebody is actively changing the repository is a *BAD* idea). +[[hacking-git]] +Hacking git +=========== + +This chapter covers internal details of the git implementation which +probably only git developers need to understand. + [[birdview-on-the-source-code]] A birds-eye view of Git's source code ------------------------------------- |