Commit | Line | Data |
---|---|---|
28513c4f MM |
1 | Git - fast, scalable, distributed revision control system |
2 | ========================================================= | |
556b6600 | 3 | |
556b6600 NP |
4 | Git is a fast, scalable, distributed revision control system with an |
5 | unusually rich command set that provides both high-level operations | |
6 | and full access to internals. | |
7 | ||
779d7e93 SL |
8 | Git is an Open Source project covered by the GNU General Public |
9 | License version 2 (some parts of it are under different licenses, | |
71ce415d JH |
10 | compatible with the GPLv2). It was originally written by Linus |
11 | Torvalds with help of a group of hackers around the net. | |
556b6600 | 12 | |
61649720 | 13 | Please read the file [INSTALL][] for installation instructions. |
aa98eb3d | 14 | |
d9b297db MM |
15 | Many Git online resources are accessible from http://git-scm.com/ |
16 | including full documentation and Git related tools. | |
17 | ||
61649720 MM |
18 | See [Documentation/gittutorial.txt][] to get started, then see |
19 | [Documentation/giteveryday.txt][] for a useful minimum set of commands, and | |
a299e3a3 | 20 | Documentation/git-<commandname>.txt for documentation of each command. |
aa98eb3d | 21 | If git has been correctly installed, then the tutorial can also be |
a299e3a3 BD |
22 | read with `man gittutorial` or `git help tutorial`, and the |
23 | documentation of each command with `man git-<commandname>` or `git help | |
24 | <commandname>`. | |
aa98eb3d | 25 | |
61649720 | 26 | CVS users may also want to read [Documentation/gitcvs-migration.txt][] |
a299e3a3 | 27 | (`man gitcvs-migration` or `git help cvs-migration` if git is |
aa98eb3d | 28 | installed). |
556b6600 | 29 | |
556b6600 NP |
30 | The user discussion and development of Git take place on the Git |
31 | mailing list -- everyone is welcome to post bug reports, feature | |
07f050c9 | 32 | requests, comments and patches to git@vger.kernel.org (read |
61649720 | 33 | [Documentation/SubmittingPatches][] for instructions on patch submission). |
07f050c9 MM |
34 | To subscribe to the list, send an email with just "subscribe git" in |
35 | the body to majordomo@vger.kernel.org. The mailing list archives are | |
33b29fd1 JH |
36 | available at http://news.gmane.org/gmane.comp.version-control.git/, |
37 | http://marc.info/?l=git and other archival sites. | |
38 | ||
39 | The maintainer frequently sends the "What's cooking" reports that | |
40 | list the current status of various development topics to the mailing | |
41 | list. The discussion following them give a good reference for | |
42 | project status, development direction and remaining tasks. | |
61649720 | 43 | |
a217f073 MM |
44 | The name "git" was given by Linus Torvalds when he wrote the very |
45 | first version. He described the tool as "the stupid content tracker" | |
46 | and the name as (depending on your mood): | |
47 | ||
48 | - random three-letter combination that is pronounceable, and not | |
49 | actually used by any common UNIX command. The fact that it is a | |
50 | mispronunciation of "get" may or may not be relevant. | |
51 | - stupid. contemptible and despicable. simple. Take your pick from the | |
52 | dictionary of slang. | |
53 | - "global information tracker": you're in a good mood, and it actually | |
54 | works for you. Angels sing, and a light suddenly fills the room. | |
55 | - "goddamn idiotic truckload of sh*t": when it breaks | |
56 | ||
61649720 MM |
57 | [INSTALL]: INSTALL |
58 | [Documentation/gittutorial.txt]: Documentation/gittutorial.txt | |
59 | [Documentation/giteveryday.txt]: Documentation/giteveryday.txt | |
61649720 MM |
60 | [Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt |
61 | [Documentation/SubmittingPatches]: Documentation/SubmittingPatches |