2020-04-11 01:18:10 +08:00
|
|
|
[![Build status](https://github.com/git/git/workflows/CI/PR/badge.svg)](https://github.com/git/git/actions?query=branch%3Amaster+event%3Apush)
|
2019-01-29 22:19:32 +08:00
|
|
|
|
2016-02-25 16:37:29 +08:00
|
|
|
Git - fast, scalable, distributed revision control system
|
|
|
|
=========================================================
|
2007-01-18 02:04:39 +08:00
|
|
|
|
|
|
|
Git is a fast, scalable, distributed revision control system with an
|
|
|
|
unusually rich command set that provides both high-level operations
|
|
|
|
and full access to internals.
|
|
|
|
|
2012-12-14 23:37:47 +08:00
|
|
|
Git is an Open Source project covered by the GNU General Public
|
|
|
|
License version 2 (some parts of it are under different licenses,
|
2012-12-16 14:24:10 +08:00
|
|
|
compatible with the GPLv2). It was originally written by Linus
|
|
|
|
Torvalds with help of a group of hackers around the net.
|
2007-01-18 02:04:39 +08:00
|
|
|
|
2016-02-25 16:37:27 +08:00
|
|
|
Please read the file [INSTALL][] for installation instructions.
|
2009-02-25 04:16:37 +08:00
|
|
|
|
2017-03-02 06:22:04 +08:00
|
|
|
Many Git online resources are accessible from <https://git-scm.com/>
|
2016-02-25 16:37:28 +08:00
|
|
|
including full documentation and Git related tools.
|
|
|
|
|
2016-02-25 16:37:27 +08:00
|
|
|
See [Documentation/gittutorial.txt][] to get started, then see
|
|
|
|
[Documentation/giteveryday.txt][] for a useful minimum set of commands, and
|
2019-07-19 03:08:45 +08:00
|
|
|
`Documentation/git-<commandname>.txt` for documentation of each command.
|
2009-02-25 04:16:37 +08:00
|
|
|
If git has been correctly installed, then the tutorial can also be
|
2016-05-30 11:08:16 +08:00
|
|
|
read with `man gittutorial` or `git help tutorial`, and the
|
|
|
|
documentation of each command with `man git-<commandname>` or `git help
|
|
|
|
<commandname>`.
|
2009-02-25 04:16:37 +08:00
|
|
|
|
2016-02-25 16:37:27 +08:00
|
|
|
CVS users may also want to read [Documentation/gitcvs-migration.txt][]
|
2016-05-30 11:08:16 +08:00
|
|
|
(`man gitcvs-migration` or `git help cvs-migration` if git is
|
2009-02-25 04:16:37 +08:00
|
|
|
installed).
|
2007-01-18 02:04:39 +08:00
|
|
|
|
|
|
|
The user discussion and development of Git take place on the Git
|
|
|
|
mailing list -- everyone is welcome to post bug reports, feature
|
2012-02-23 20:52:06 +08:00
|
|
|
requests, comments and patches to git@vger.kernel.org (read
|
2016-02-25 16:37:27 +08:00
|
|
|
[Documentation/SubmittingPatches][] for instructions on patch submission).
|
2012-02-23 20:52:06 +08:00
|
|
|
To subscribe to the list, send an email with just "subscribe git" in
|
|
|
|
the body to majordomo@vger.kernel.org. The mailing list archives are
|
2019-11-27 20:53:43 +08:00
|
|
|
available at <https://lore.kernel.org/git/>,
|
2017-03-02 06:22:04 +08:00
|
|
|
<http://marc.info/?l=git> and other archival sites.
|
2013-01-30 03:10:58 +08:00
|
|
|
|
2018-05-31 04:52:55 +08:00
|
|
|
Issues which are security relevant should be disclosed privately to
|
|
|
|
the Git Security mailing list <git-security@googlegroups.com>.
|
|
|
|
|
2013-01-30 03:10:58 +08:00
|
|
|
The maintainer frequently sends the "What's cooking" reports that
|
|
|
|
list the current status of various development topics to the mailing
|
|
|
|
list. The discussion following them give a good reference for
|
|
|
|
project status, development direction and remaining tasks.
|
2016-02-25 16:37:27 +08:00
|
|
|
|
2016-02-25 16:37:30 +08:00
|
|
|
The name "git" was given by Linus Torvalds when he wrote the very
|
|
|
|
first version. He described the tool as "the stupid content tracker"
|
|
|
|
and the name as (depending on your mood):
|
|
|
|
|
|
|
|
- random three-letter combination that is pronounceable, and not
|
|
|
|
actually used by any common UNIX command. The fact that it is a
|
|
|
|
mispronunciation of "get" may or may not be relevant.
|
|
|
|
- stupid. contemptible and despicable. simple. Take your pick from the
|
|
|
|
dictionary of slang.
|
|
|
|
- "global information tracker": you're in a good mood, and it actually
|
|
|
|
works for you. Angels sing, and a light suddenly fills the room.
|
|
|
|
- "goddamn idiotic truckload of sh*t": when it breaks
|
|
|
|
|
2016-02-25 16:37:27 +08:00
|
|
|
[INSTALL]: INSTALL
|
|
|
|
[Documentation/gittutorial.txt]: Documentation/gittutorial.txt
|
|
|
|
[Documentation/giteveryday.txt]: Documentation/giteveryday.txt
|
|
|
|
[Documentation/gitcvs-migration.txt]: Documentation/gitcvs-migration.txt
|
|
|
|
[Documentation/SubmittingPatches]: Documentation/SubmittingPatches
|