← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/dulwich/oneiric

« back to all changes in this revision

Viewing changes to docs/tutorial/0-introduction.txt

  • Committer: Bazaar Package Importer
  • Author(s): Jelmer Vernooij
  • Date: 2011-01-21 19:38:13 UTC
  • mfrom: (1.2.14 upstream)
  • Revision ID: james.westby@ubuntu.com-20110121193813-2cnp21akwf5j0pq2
Tags: 0.7.0-1
* New upstream release.
 + Changes default test runner from nose to testtools.
* Drop Pure- from the description.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/tutorial/0-introduction.txt
45
45
The Tree
46
46
--------
47
47
 
48
 
A tree is a collection of file information, the state of your working copy at
 
48
A tree is a collection of file information, the state of a single directory at
49
49
a given point in time.
50
50
 
51
51
A tree file looks like this::
52
52
 
53
 
  tree <content length><NUL><file mode> <filename><NUL><blob sha>...
 
53
  tree <content length><NUL><file mode> <filename><NUL><item sha>...
54
54
 
55
55
And repeats for every file in the tree.
56
56
 
57
 
Note that for a unknown reason, the SHA-1 digest is in binary form here.
 
57
Note that the SHA-1 digest is in binary form here.
58
58
 
59
59
The file mode is like the octal argument you could give to the ``chmod``
60
60
command.  Except it is in extended form to tell regular files from
88
88
More About Git formats
89
89
----------------------
90
90
 
91
 
These three objects make 90 % of a Git repository. The rest is branch
92
 
information and optimizations.
93
 
 
94
 
For instance there is an index of the current state of the working copy.
95
 
There are also pack files to group several small objects in a single indexed
96
 
file.
97
 
 
98
 
For a more detailled explanation of object formats and SHA-1 digests, see:
 
91
These three objects make up most of the contents of a Git repository and are
 
92
used for the history. They can either appear as simple files on disk (one file
 
93
per object) or in a ``pack`` file, which is a container for a number of these
 
94
objects.
 
95
 
 
96
The is also an index of the current state of the working copy in the
 
97
repository as well as files to track the existing branches and tags.
 
98
 
 
99
For a more detailed explanation of object formats and SHA-1 digests, see:
99
100
http://www-cs-students.stanford.edu/~blynn/gitmagic/ch08.html
100
101
 
101
102
Just note that recent versions of Git compress object files using zlib.