2008-06-06 07:07:32 +00:00
|
|
|
git(1)
|
2005-05-10 21:32:30 +00:00
|
|
|
======
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
git - the stupid content tracker
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2006-08-25 01:05:48 +00:00
|
|
|
[verse]
|
2012-02-14 23:54:21 +00:00
|
|
|
'git' [--version] [--help] [-c <name>=<value>]
|
|
|
|
[--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
|
2011-07-08 23:14:10 +00:00
|
|
|
[-p|--paginate|--no-pager] [--no-replace-objects] [--bare]
|
|
|
|
[--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
|
2012-02-14 23:54:21 +00:00
|
|
|
<command> [<args>]
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2006-04-02 21:54:34 +00: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.
|
|
|
|
|
2008-06-30 22:01:21 +00:00
|
|
|
See linkgit:gittutorial[7] to get started, then see
|
2006-04-02 21:54:34 +00:00
|
|
|
link:everyday.html[Everyday Git] for a useful minimum set of commands, and
|
|
|
|
"man git-commandname" for documentation of each command. CVS users may
|
2008-06-30 22:01:21 +00:00
|
|
|
also want to read linkgit:gitcvs-migration[7]. See
|
|
|
|
the link:user-manual.html[Git User's Manual] for a more in-depth
|
2007-05-07 05:01:42 +00:00
|
|
|
introduction.
|
2005-11-15 23:31:25 +00:00
|
|
|
|
2010-10-08 17:31:15 +00:00
|
|
|
The '<command>' is either a name of a Git command (see below) or an alias
|
2007-12-29 06:20:38 +00:00
|
|
|
as defined in the configuration file (see linkgit:git-config[1]).
|
2006-06-07 18:43:50 +00:00
|
|
|
|
2007-04-30 11:21:38 +00:00
|
|
|
Formatted and hyperlinked version of the latest git
|
|
|
|
documentation can be viewed at
|
2012-08-17 19:14:57 +00:00
|
|
|
`http://git-htmldocs.googlecode.com/git/git.html`.
|
2007-04-30 11:21:38 +00:00
|
|
|
|
2007-02-13 23:15:05 +00:00
|
|
|
ifdef::stalenotes[]
|
|
|
|
[NOTE]
|
|
|
|
============
|
|
|
|
|
2007-05-19 04:43:13 +00:00
|
|
|
You are reading the documentation for the latest (possibly
|
|
|
|
unreleased) version of git, that is available from 'master'
|
|
|
|
branch of the `git.git` repository.
|
|
|
|
Documentation for older releases are available here:
|
2007-03-28 22:40:17 +00:00
|
|
|
|
2012-08-20 00:02:11 +00:00
|
|
|
* link:v1.7.12/git.html[documentation for release 1.7.12]
|
|
|
|
|
|
|
|
* release notes for
|
|
|
|
link:RelNotes/1.7.12.txt[1.7.12].
|
|
|
|
|
2012-08-15 20:39:53 +00:00
|
|
|
* link:v1.7.11.5/git.html[documentation for release 1.7.11.5]
|
2012-06-17 21:07:15 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-08-15 20:39:53 +00:00
|
|
|
link:RelNotes/1.7.11.5.txt[1.7.11.5],
|
2012-07-30 20:09:25 +00:00
|
|
|
link:RelNotes/1.7.11.4.txt[1.7.11.4],
|
2012-07-22 20:07:40 +00:00
|
|
|
link:RelNotes/1.7.11.3.txt[1.7.11.3],
|
2012-07-11 19:55:38 +00:00
|
|
|
link:RelNotes/1.7.11.2.txt[1.7.11.2],
|
2012-06-21 20:16:46 +00:00
|
|
|
link:RelNotes/1.7.11.1.txt[1.7.11.1],
|
2012-06-17 21:07:15 +00:00
|
|
|
link:RelNotes/1.7.11.txt[1.7.11].
|
|
|
|
|
2012-06-17 21:04:15 +00:00
|
|
|
* link:v1.7.10.5/git.html[documentation for release 1.7.10.5]
|
2012-04-06 17:47:58 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-06-17 21:04:15 +00:00
|
|
|
link:RelNotes/1.7.10.5.txt[1.7.10.5],
|
2012-06-03 22:53:58 +00:00
|
|
|
link:RelNotes/1.7.10.4.txt[1.7.10.4],
|
2012-06-01 20:05:27 +00:00
|
|
|
link:RelNotes/1.7.10.3.txt[1.7.10.3],
|
2012-05-11 18:25:28 +00:00
|
|
|
link:RelNotes/1.7.10.2.txt[1.7.10.2],
|
2012-05-02 04:18:44 +00:00
|
|
|
link:RelNotes/1.7.10.1.txt[1.7.10.1],
|
2012-04-06 17:47:58 +00:00
|
|
|
link:RelNotes/1.7.10.txt[1.7.10].
|
|
|
|
|
2012-04-26 17:23:15 +00:00
|
|
|
* link:v1.7.9.7/git.html[documentation for release 1.7.9.7]
|
2012-01-27 19:31:02 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-04-26 17:23:15 +00:00
|
|
|
link:RelNotes/1.7.9.7.txt[1.7.9.7],
|
2012-04-02 20:07:58 +00:00
|
|
|
link:RelNotes/1.7.9.6.txt[1.7.9.6],
|
2012-03-26 19:23:34 +00:00
|
|
|
link:RelNotes/1.7.9.5.txt[1.7.9.5],
|
2012-03-12 22:52:52 +00:00
|
|
|
link:RelNotes/1.7.9.4.txt[1.7.9.4],
|
2012-03-05 22:29:07 +00:00
|
|
|
link:RelNotes/1.7.9.3.txt[1.7.9.3],
|
2012-02-23 01:48:01 +00:00
|
|
|
link:RelNotes/1.7.9.2.txt[1.7.9.2],
|
2012-02-14 17:53:38 +00:00
|
|
|
link:RelNotes/1.7.9.1.txt[1.7.9.1],
|
2012-01-27 19:31:02 +00:00
|
|
|
link:RelNotes/1.7.9.txt[1.7.9].
|
|
|
|
|
2012-04-26 16:59:22 +00:00
|
|
|
* link:v1.7.8.6/git.html[documentation for release 1.7.8.6]
|
2011-12-02 17:31:32 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-04-26 16:59:22 +00:00
|
|
|
link:RelNotes/1.7.8.6.txt[1.7.8.6],
|
2012-04-02 20:07:58 +00:00
|
|
|
link:RelNotes/1.7.8.5.txt[1.7.8.5],
|
2012-01-18 23:51:00 +00:00
|
|
|
link:RelNotes/1.7.8.4.txt[1.7.8.4],
|
2012-01-06 20:41:39 +00:00
|
|
|
link:RelNotes/1.7.8.3.txt[1.7.8.3],
|
|
|
|
link:RelNotes/1.7.8.2.txt[1.7.8.2],
|
|
|
|
link:RelNotes/1.7.8.1.txt[1.7.8.1],
|
2011-12-02 17:31:32 +00:00
|
|
|
link:RelNotes/1.7.8.txt[1.7.8].
|
|
|
|
|
2012-04-26 16:41:52 +00:00
|
|
|
* link:v1.7.7.7/git.html[documentation for release 1.7.7.7]
|
2011-09-30 21:20:57 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-04-26 16:41:52 +00:00
|
|
|
link:RelNotes/1.7.7.7.txt[1.7.7.7],
|
2012-01-18 23:51:00 +00:00
|
|
|
link:RelNotes/1.7.7.6.txt[1.7.7.6],
|
2011-12-14 05:55:31 +00:00
|
|
|
link:RelNotes/1.7.7.5.txt[1.7.7.5],
|
|
|
|
link:RelNotes/1.7.7.4.txt[1.7.7.4],
|
|
|
|
link:RelNotes/1.7.7.3.txt[1.7.7.3],
|
|
|
|
link:RelNotes/1.7.7.2.txt[1.7.7.2],
|
2011-10-24 04:48:06 +00:00
|
|
|
link:RelNotes/1.7.7.1.txt[1.7.7.1],
|
2011-09-30 21:20:57 +00:00
|
|
|
link:RelNotes/1.7.7.txt[1.7.7].
|
|
|
|
|
2012-02-06 07:46:44 +00:00
|
|
|
* link:v1.7.6.6/git.html[documentation for release 1.7.6.6]
|
2011-06-26 19:41:16 +00:00
|
|
|
|
|
|
|
* release notes for
|
2012-02-06 07:46:44 +00:00
|
|
|
link:RelNotes/1.7.6.6.txt[1.7.6.6],
|
2011-12-14 05:30:40 +00:00
|
|
|
link:RelNotes/1.7.6.5.txt[1.7.6.5],
|
2011-09-23 21:38:39 +00:00
|
|
|
link:RelNotes/1.7.6.4.txt[1.7.6.4],
|
2011-09-12 17:33:03 +00:00
|
|
|
link:RelNotes/1.7.6.3.txt[1.7.6.3],
|
2011-09-06 18:41:02 +00:00
|
|
|
link:RelNotes/1.7.6.2.txt[1.7.6.2],
|
|
|
|
link:RelNotes/1.7.6.1.txt[1.7.6.1],
|
2011-06-26 19:41:16 +00:00
|
|
|
link:RelNotes/1.7.6.txt[1.7.6].
|
|
|
|
|
2011-06-01 21:08:26 +00:00
|
|
|
* link:v1.7.5.4/git.html[documentation for release 1.7.5.4]
|
2011-04-24 06:36:32 +00:00
|
|
|
|
|
|
|
* release notes for
|
2011-06-01 21:08:26 +00:00
|
|
|
link:RelNotes/1.7.5.4.txt[1.7.5.4],
|
2011-05-26 16:45:29 +00:00
|
|
|
link:RelNotes/1.7.5.3.txt[1.7.5.3],
|
2011-05-20 03:30:44 +00:00
|
|
|
link:RelNotes/1.7.5.2.txt[1.7.5.2],
|
2011-05-04 22:47:40 +00:00
|
|
|
link:RelNotes/1.7.5.1.txt[1.7.5.1],
|
2011-04-24 06:36:32 +00:00
|
|
|
link:RelNotes/1.7.5.txt[1.7.5].
|
|
|
|
|
2011-04-19 18:51:00 +00:00
|
|
|
* link:v1.7.4.5/git.html[documentation for release 1.7.4.5]
|
2011-01-30 19:53:13 +00:00
|
|
|
|
|
|
|
* release notes for
|
2011-04-19 18:51:00 +00:00
|
|
|
link:RelNotes/1.7.4.5.txt[1.7.4.5],
|
2011-04-06 17:57:32 +00:00
|
|
|
link:RelNotes/1.7.4.4.txt[1.7.4.4],
|
2011-04-03 07:18:50 +00:00
|
|
|
link:RelNotes/1.7.4.3.txt[1.7.4.3],
|
|
|
|
link:RelNotes/1.7.4.2.txt[1.7.4.2],
|
2011-02-11 22:39:55 +00:00
|
|
|
link:RelNotes/1.7.4.1.txt[1.7.4.1],
|
2011-01-30 19:53:13 +00:00
|
|
|
link:RelNotes/1.7.4.txt[1.7.4].
|
|
|
|
|
2011-01-05 22:46:07 +00:00
|
|
|
* link:v1.7.3.5/git.html[documentation for release 1.7.3.5]
|
2010-09-18 21:55:08 +00:00
|
|
|
|
|
|
|
* release notes for
|
2011-01-05 22:46:07 +00:00
|
|
|
link:RelNotes/1.7.3.5.txt[1.7.3.5],
|
2010-12-15 23:30:49 +00:00
|
|
|
link:RelNotes/1.7.3.4.txt[1.7.3.4],
|
2010-12-09 23:52:12 +00:00
|
|
|
link:RelNotes/1.7.3.3.txt[1.7.3.3],
|
2010-10-22 00:14:32 +00:00
|
|
|
link:RelNotes/1.7.3.2.txt[1.7.3.2],
|
2010-09-29 16:42:53 +00:00
|
|
|
link:RelNotes/1.7.3.1.txt[1.7.3.1],
|
2010-09-18 21:55:08 +00:00
|
|
|
link:RelNotes/1.7.3.txt[1.7.3].
|
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.7.2.5/git.html[documentation for release 1.7.2.5]
|
2010-07-21 19:55:50 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.7.2.5.txt[1.7.2.5],
|
2010-12-09 23:52:12 +00:00
|
|
|
link:RelNotes/1.7.2.4.txt[1.7.2.4],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.7.2.3.txt[1.7.2.3],
|
|
|
|
link:RelNotes/1.7.2.2.txt[1.7.2.2],
|
|
|
|
link:RelNotes/1.7.2.1.txt[1.7.2.1],
|
|
|
|
link:RelNotes/1.7.2.txt[1.7.2].
|
2010-07-21 19:55:50 +00:00
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.7.1.4/git.html[documentation for release 1.7.1.4]
|
2010-04-24 01:27:17 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.7.1.4.txt[1.7.1.4],
|
2010-12-09 23:52:12 +00:00
|
|
|
link:RelNotes/1.7.1.3.txt[1.7.1.3],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.7.1.2.txt[1.7.1.2],
|
|
|
|
link:RelNotes/1.7.1.1.txt[1.7.1.1],
|
|
|
|
link:RelNotes/1.7.1.txt[1.7.1].
|
2010-04-24 01:27:17 +00:00
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.7.0.9/git.html[documentation for release 1.7.0.9]
|
2010-02-12 23:45:05 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.7.0.9.txt[1.7.0.9],
|
2010-12-09 23:52:12 +00:00
|
|
|
link:RelNotes/1.7.0.8.txt[1.7.0.8],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.7.0.7.txt[1.7.0.7],
|
|
|
|
link:RelNotes/1.7.0.6.txt[1.7.0.6],
|
|
|
|
link:RelNotes/1.7.0.5.txt[1.7.0.5],
|
|
|
|
link:RelNotes/1.7.0.4.txt[1.7.0.4],
|
|
|
|
link:RelNotes/1.7.0.3.txt[1.7.0.3],
|
|
|
|
link:RelNotes/1.7.0.2.txt[1.7.0.2],
|
|
|
|
link:RelNotes/1.7.0.1.txt[1.7.0.1],
|
|
|
|
link:RelNotes/1.7.0.txt[1.7.0].
|
2010-02-12 23:45:05 +00:00
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.6.6.3/git.html[documentation for release 1.6.6.3]
|
2009-12-23 19:58:52 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.6.6.3.txt[1.6.6.3],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.6.2.txt[1.6.6.2],
|
|
|
|
link:RelNotes/1.6.6.1.txt[1.6.6.1],
|
|
|
|
link:RelNotes/1.6.6.txt[1.6.6].
|
2009-12-23 19:58:52 +00:00
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.6.5.9/git.html[documentation for release 1.6.5.9]
|
2009-10-10 07:05:19 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.6.5.9.txt[1.6.5.9],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.5.8.txt[1.6.5.8],
|
|
|
|
link:RelNotes/1.6.5.7.txt[1.6.5.7],
|
|
|
|
link:RelNotes/1.6.5.6.txt[1.6.5.6],
|
|
|
|
link:RelNotes/1.6.5.5.txt[1.6.5.5],
|
|
|
|
link:RelNotes/1.6.5.4.txt[1.6.5.4],
|
|
|
|
link:RelNotes/1.6.5.3.txt[1.6.5.3],
|
|
|
|
link:RelNotes/1.6.5.2.txt[1.6.5.2],
|
|
|
|
link:RelNotes/1.6.5.1.txt[1.6.5.1],
|
|
|
|
link:RelNotes/1.6.5.txt[1.6.5].
|
2009-10-10 07:05:19 +00:00
|
|
|
|
2010-12-17 05:43:08 +00:00
|
|
|
* link:v1.6.4.5/git.html[documentation for release 1.6.4.5]
|
2009-07-29 07:32:42 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-12-17 05:43:08 +00:00
|
|
|
link:RelNotes/1.6.4.5.txt[1.6.4.5],
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.4.4.txt[1.6.4.4],
|
|
|
|
link:RelNotes/1.6.4.3.txt[1.6.4.3],
|
|
|
|
link:RelNotes/1.6.4.2.txt[1.6.4.2],
|
|
|
|
link:RelNotes/1.6.4.1.txt[1.6.4.1],
|
|
|
|
link:RelNotes/1.6.4.txt[1.6.4].
|
2009-07-29 07:32:42 +00:00
|
|
|
|
2009-07-29 07:00:56 +00:00
|
|
|
* link:v1.6.3.4/git.html[documentation for release 1.6.3.4]
|
2009-06-04 05:52:37 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.3.4.txt[1.6.3.4],
|
|
|
|
link:RelNotes/1.6.3.3.txt[1.6.3.3],
|
|
|
|
link:RelNotes/1.6.3.2.txt[1.6.3.2],
|
|
|
|
link:RelNotes/1.6.3.1.txt[1.6.3.1],
|
|
|
|
link:RelNotes/1.6.3.txt[1.6.3].
|
2009-03-04 07:02:16 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.2.5.txt[1.6.2.5],
|
|
|
|
link:RelNotes/1.6.2.4.txt[1.6.2.4],
|
|
|
|
link:RelNotes/1.6.2.3.txt[1.6.2.3],
|
|
|
|
link:RelNotes/1.6.2.2.txt[1.6.2.2],
|
|
|
|
link:RelNotes/1.6.2.1.txt[1.6.2.1],
|
|
|
|
link:RelNotes/1.6.2.txt[1.6.2].
|
2009-03-04 07:02:16 +00:00
|
|
|
|
2009-02-07 19:06:34 +00:00
|
|
|
* link:v1.6.1.3/git.html[documentation for release 1.6.1.3]
|
2008-12-25 03:41:08 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.1.3.txt[1.6.1.3],
|
|
|
|
link:RelNotes/1.6.1.2.txt[1.6.1.2],
|
|
|
|
link:RelNotes/1.6.1.1.txt[1.6.1.1],
|
|
|
|
link:RelNotes/1.6.1.txt[1.6.1].
|
2008-12-25 03:41:08 +00:00
|
|
|
|
2008-12-20 03:32:29 +00:00
|
|
|
* link:v1.6.0.6/git.html[documentation for release 1.6.0.6]
|
2008-08-17 18:42:10 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.6.0.6.txt[1.6.0.6],
|
|
|
|
link:RelNotes/1.6.0.5.txt[1.6.0.5],
|
|
|
|
link:RelNotes/1.6.0.4.txt[1.6.0.4],
|
|
|
|
link:RelNotes/1.6.0.3.txt[1.6.0.3],
|
|
|
|
link:RelNotes/1.6.0.2.txt[1.6.0.2],
|
|
|
|
link:RelNotes/1.6.0.1.txt[1.6.0.1],
|
|
|
|
link:RelNotes/1.6.0.txt[1.6.0].
|
2008-08-17 18:42:10 +00:00
|
|
|
|
2008-12-20 03:32:29 +00:00
|
|
|
* link:v1.5.6.6/git.html[documentation for release 1.5.6.6]
|
2008-06-18 20:09:43 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.6.6.txt[1.5.6.6],
|
|
|
|
link:RelNotes/1.5.6.5.txt[1.5.6.5],
|
|
|
|
link:RelNotes/1.5.6.4.txt[1.5.6.4],
|
|
|
|
link:RelNotes/1.5.6.3.txt[1.5.6.3],
|
|
|
|
link:RelNotes/1.5.6.2.txt[1.5.6.2],
|
|
|
|
link:RelNotes/1.5.6.1.txt[1.5.6.1],
|
|
|
|
link:RelNotes/1.5.6.txt[1.5.6].
|
2008-06-18 20:09:43 +00:00
|
|
|
|
2008-12-20 03:32:29 +00:00
|
|
|
* link:v1.5.5.6/git.html[documentation for release 1.5.5.6]
|
2008-04-08 04:57:43 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.5.6.txt[1.5.5.6],
|
|
|
|
link:RelNotes/1.5.5.5.txt[1.5.5.5],
|
|
|
|
link:RelNotes/1.5.5.4.txt[1.5.5.4],
|
|
|
|
link:RelNotes/1.5.5.3.txt[1.5.5.3],
|
|
|
|
link:RelNotes/1.5.5.2.txt[1.5.5.2],
|
|
|
|
link:RelNotes/1.5.5.1.txt[1.5.5.1],
|
|
|
|
link:RelNotes/1.5.5.txt[1.5.5].
|
2008-04-08 04:57:43 +00:00
|
|
|
|
2008-12-20 03:32:29 +00:00
|
|
|
* link:v1.5.4.7/git.html[documentation for release 1.5.4.7]
|
2008-02-02 04:40:30 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.4.7.txt[1.5.4.7],
|
|
|
|
link:RelNotes/1.5.4.6.txt[1.5.4.6],
|
|
|
|
link:RelNotes/1.5.4.5.txt[1.5.4.5],
|
|
|
|
link:RelNotes/1.5.4.4.txt[1.5.4.4],
|
|
|
|
link:RelNotes/1.5.4.3.txt[1.5.4.3],
|
|
|
|
link:RelNotes/1.5.4.2.txt[1.5.4.2],
|
|
|
|
link:RelNotes/1.5.4.1.txt[1.5.4.1],
|
|
|
|
link:RelNotes/1.5.4.txt[1.5.4].
|
2008-02-02 04:40:30 +00:00
|
|
|
|
2008-01-08 07:39:02 +00:00
|
|
|
* link:v1.5.3.8/git.html[documentation for release 1.5.3.8]
|
2007-09-02 22:16:44 +00:00
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.3.8.txt[1.5.3.8],
|
|
|
|
link:RelNotes/1.5.3.7.txt[1.5.3.7],
|
|
|
|
link:RelNotes/1.5.3.6.txt[1.5.3.6],
|
|
|
|
link:RelNotes/1.5.3.5.txt[1.5.3.5],
|
|
|
|
link:RelNotes/1.5.3.4.txt[1.5.3.4],
|
|
|
|
link:RelNotes/1.5.3.3.txt[1.5.3.3],
|
|
|
|
link:RelNotes/1.5.3.2.txt[1.5.3.2],
|
|
|
|
link:RelNotes/1.5.3.1.txt[1.5.3.1],
|
|
|
|
link:RelNotes/1.5.3.txt[1.5.3].
|
2007-05-19 00:28:24 +00:00
|
|
|
|
2008-06-26 00:09:40 +00:00
|
|
|
* link:v1.5.2.5/git.html[documentation for release 1.5.2.5]
|
|
|
|
|
2007-05-20 07:30:39 +00:00
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.2.5.txt[1.5.2.5],
|
|
|
|
link:RelNotes/1.5.2.4.txt[1.5.2.4],
|
|
|
|
link:RelNotes/1.5.2.3.txt[1.5.2.3],
|
|
|
|
link:RelNotes/1.5.2.2.txt[1.5.2.2],
|
|
|
|
link:RelNotes/1.5.2.1.txt[1.5.2.1],
|
|
|
|
link:RelNotes/1.5.2.txt[1.5.2].
|
2007-05-20 07:30:39 +00:00
|
|
|
|
|
|
|
* link:v1.5.1.6/git.html[documentation for release 1.5.1.6]
|
|
|
|
|
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.1.6.txt[1.5.1.6],
|
|
|
|
link:RelNotes/1.5.1.5.txt[1.5.1.5],
|
|
|
|
link:RelNotes/1.5.1.4.txt[1.5.1.4],
|
|
|
|
link:RelNotes/1.5.1.3.txt[1.5.1.3],
|
|
|
|
link:RelNotes/1.5.1.2.txt[1.5.1.2],
|
|
|
|
link:RelNotes/1.5.1.1.txt[1.5.1.1],
|
|
|
|
link:RelNotes/1.5.1.txt[1.5.1].
|
2007-05-19 04:43:13 +00:00
|
|
|
|
|
|
|
* link:v1.5.0.7/git.html[documentation for release 1.5.0.7]
|
|
|
|
|
2007-05-20 07:30:39 +00:00
|
|
|
* release notes for
|
2010-09-07 00:29:57 +00:00
|
|
|
link:RelNotes/1.5.0.7.txt[1.5.0.7],
|
|
|
|
link:RelNotes/1.5.0.6.txt[1.5.0.6],
|
|
|
|
link:RelNotes/1.5.0.5.txt[1.5.0.5],
|
|
|
|
link:RelNotes/1.5.0.3.txt[1.5.0.3],
|
|
|
|
link:RelNotes/1.5.0.2.txt[1.5.0.2],
|
|
|
|
link:RelNotes/1.5.0.1.txt[1.5.0.1],
|
|
|
|
link:RelNotes/1.5.0.txt[1.5.0].
|
2007-05-19 04:43:13 +00:00
|
|
|
|
|
|
|
* documentation for release link:v1.4.4.4/git.html[1.4.4.4],
|
|
|
|
link:v1.3.3/git.html[1.3.3],
|
|
|
|
link:v1.2.6/git.html[1.2.6],
|
|
|
|
link:v1.0.13/git.html[1.0.13].
|
2007-02-13 23:15:05 +00:00
|
|
|
|
|
|
|
============
|
|
|
|
|
|
|
|
endif::stalenotes[]
|
|
|
|
|
2005-11-15 23:31:25 +00:00
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
--version::
|
2006-03-09 16:24:19 +00:00
|
|
|
Prints the git suite version that the 'git' program came from.
|
2005-11-15 23:31:25 +00:00
|
|
|
|
|
|
|
--help::
|
2006-03-09 16:24:19 +00:00
|
|
|
Prints the synopsis and a list of the most commonly used
|
2007-12-04 05:44:29 +00:00
|
|
|
commands. If the option '--all' or '-a' is given then all
|
|
|
|
available commands are printed. If a git command is named this
|
|
|
|
option will bring up the manual page for that command.
|
2007-12-04 05:44:29 +00:00
|
|
|
+
|
|
|
|
Other options are available to control how the manual page is
|
2007-12-29 06:20:38 +00:00
|
|
|
displayed. See linkgit:git-help[1] for more information,
|
2008-07-03 06:06:23 +00:00
|
|
|
because `git --help ...` is converted internally into `git
|
|
|
|
help ...`.
|
2005-11-15 23:31:25 +00:00
|
|
|
|
2010-03-26 22:53:57 +00:00
|
|
|
-c <name>=<value>::
|
|
|
|
Pass a configuration parameter to the command. The value
|
|
|
|
given will override values from configuration files.
|
|
|
|
The <name> is expected in the same format as listed by
|
|
|
|
'git config' (subkeys separated by dots).
|
|
|
|
|
2010-10-08 17:31:15 +00:00
|
|
|
--exec-path[=<path>]::
|
2006-03-09 16:24:19 +00:00
|
|
|
Path to wherever your core git programs are installed.
|
2005-11-15 23:31:25 +00:00
|
|
|
This can also be controlled by setting the GIT_EXEC_PATH
|
2008-07-03 05:08:12 +00:00
|
|
|
environment variable. If no path is given, 'git' will print
|
2005-11-15 23:31:25 +00:00
|
|
|
the current setting and then exit.
|
|
|
|
|
2009-04-05 02:15:16 +00:00
|
|
|
--html-path::
|
2011-05-02 06:07:45 +00:00
|
|
|
Print the path, without trailing slash, where git's HTML
|
|
|
|
documentation is installed and exit.
|
2009-04-05 02:15:16 +00:00
|
|
|
|
2011-05-01 08:16:25 +00:00
|
|
|
--man-path::
|
2011-05-02 06:07:45 +00:00
|
|
|
Print the manpath (see `man(1)`) for the man pages for
|
|
|
|
this version of git and exit.
|
2011-05-01 08:16:25 +00:00
|
|
|
|
|
|
|
--info-path::
|
2011-05-02 06:07:45 +00:00
|
|
|
Print the path where the Info files documenting this
|
|
|
|
version of git are installed and exit.
|
2009-04-05 02:15:16 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-p::
|
|
|
|
--paginate::
|
2010-02-14 12:02:35 +00:00
|
|
|
Pipe all output into 'less' (or if set, $PAGER) if standard
|
|
|
|
output is a terminal. This overrides the `pager.<cmd>`
|
|
|
|
configuration options (see the "Configuration Mechanism" section
|
|
|
|
below).
|
2006-07-25 18:24:22 +00:00
|
|
|
|
2007-08-19 17:24:36 +00:00
|
|
|
--no-pager::
|
|
|
|
Do not pipe git output into a pager.
|
|
|
|
|
2006-07-25 18:24:22 +00:00
|
|
|
--git-dir=<path>::
|
|
|
|
Set the path to the repository. This can also be controlled by
|
2008-04-28 20:09:20 +00:00
|
|
|
setting the GIT_DIR environment variable. It can be an absolute
|
|
|
|
path or relative path to current working directory.
|
2006-07-25 18:24:22 +00:00
|
|
|
|
2007-06-06 07:10:42 +00:00
|
|
|
--work-tree=<path>::
|
2011-01-23 23:49:41 +00:00
|
|
|
Set the path to the working tree. It can be an absolute path
|
|
|
|
or a path relative to the current working directory.
|
2007-06-06 07:10:42 +00:00
|
|
|
This can also be controlled by setting the GIT_WORK_TREE
|
|
|
|
environment variable and the core.worktree configuration
|
2011-01-23 23:49:41 +00:00
|
|
|
variable (see core.worktree in linkgit:git-config[1] for a
|
|
|
|
more detailed discussion).
|
2007-06-06 07:10:42 +00:00
|
|
|
|
2011-07-08 23:14:10 +00:00
|
|
|
--namespace=<path>::
|
|
|
|
Set the git namespace. See linkgit:gitnamespaces[7] for more
|
|
|
|
details. Equivalent to setting the `GIT_NAMESPACE` environment
|
|
|
|
variable.
|
|
|
|
|
2006-07-25 18:24:22 +00:00
|
|
|
--bare::
|
2007-08-28 05:41:23 +00:00
|
|
|
Treat the repository as a bare repository. If GIT_DIR
|
|
|
|
environment is not set, it is set to the current working
|
|
|
|
directory.
|
|
|
|
|
2009-10-12 20:30:32 +00:00
|
|
|
--no-replace-objects::
|
|
|
|
Do not use replacement refs to replace git objects. See
|
|
|
|
linkgit:git-replace[1] for more information.
|
|
|
|
|
2005-12-13 10:38:24 +00:00
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
FURTHER DOCUMENTATION
|
|
|
|
---------------------
|
2005-12-13 10:38:24 +00:00
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
See the references above to get started using git. The following is
|
|
|
|
probably more detail than necessary for a first-time user.
|
2005-08-30 20:51:01 +00:00
|
|
|
|
2007-09-03 04:01:19 +00:00
|
|
|
The link:user-manual.html#git-concepts[git concepts chapter of the
|
2008-06-30 22:01:21 +00:00
|
|
|
user-manual] and linkgit:gitcore-tutorial[7] both provide
|
2007-09-03 04:01:19 +00:00
|
|
|
introductions to the underlying git architecture.
|
2005-08-25 07:28:18 +00:00
|
|
|
|
2009-06-06 13:11:07 +00:00
|
|
|
See linkgit:gitworkflows[7] for an overview of recommended workflows.
|
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
See also the link:howto-index.html[howto] documents for some useful
|
|
|
|
examples.
|
2005-12-13 10:38:24 +00:00
|
|
|
|
2008-06-30 22:01:21 +00:00
|
|
|
The internals are documented in the
|
|
|
|
link:technical/api-index.html[GIT API documentation].
|
2007-11-25 07:48:04 +00:00
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
GIT COMMANDS
|
|
|
|
------------
|
2005-12-13 10:38:24 +00:00
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
We divide git into high level ("porcelain") commands and low level
|
|
|
|
("plumbing") commands.
|
2005-12-10 07:41:03 +00:00
|
|
|
|
2006-04-02 21:54:34 +00:00
|
|
|
High-level commands (porcelain)
|
|
|
|
-------------------------------
|
|
|
|
|
|
|
|
We separate the porcelain commands into the main commands and some
|
|
|
|
ancillary user utilities.
|
|
|
|
|
|
|
|
Main porcelain commands
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
2005-08-27 04:33:46 +00:00
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-mainporcelain.txt[]
|
2005-08-15 22:48:47 +00:00
|
|
|
|
2005-08-15 15:23:06 +00:00
|
|
|
Ancillary Commands
|
2006-04-02 21:54:34 +00:00
|
|
|
~~~~~~~~~~~~~~~~~~
|
2005-07-14 07:10:48 +00:00
|
|
|
Manipulators:
|
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-ancillarymanipulators.txt[]
|
2005-05-10 21:32:37 +00:00
|
|
|
|
2005-08-15 15:23:06 +00:00
|
|
|
Interrogators:
|
2005-05-10 21:32:37 +00:00
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-ancillaryinterrogators.txt[]
|
2005-08-23 08:49:47 +00:00
|
|
|
|
2007-01-19 06:32:38 +00:00
|
|
|
|
|
|
|
Interacting with Others
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
These commands are to interact with foreign SCM and with other
|
|
|
|
people via patch over e-mail.
|
|
|
|
|
|
|
|
include::cmds-foreignscminterface.txt[]
|
|
|
|
|
|
|
|
|
2006-10-29 20:09:48 +00:00
|
|
|
Low-level commands (plumbing)
|
|
|
|
-----------------------------
|
|
|
|
|
|
|
|
Although git includes its
|
|
|
|
own porcelain layer, its low-level commands are sufficient to support
|
|
|
|
development of alternative porcelains. Developers of such porcelains
|
2007-12-29 06:20:38 +00:00
|
|
|
might start by reading about linkgit:git-update-index[1] and
|
|
|
|
linkgit:git-read-tree[1].
|
2006-10-29 20:09:48 +00:00
|
|
|
|
2007-01-19 06:32:38 +00:00
|
|
|
The interface (input, output, set of options and the semantics)
|
|
|
|
to these low-level commands are meant to be a lot more stable
|
|
|
|
than Porcelain level commands, because these commands are
|
|
|
|
primarily for scripted use. The interface to Porcelain commands
|
|
|
|
on the other hand are subject to change in order to improve the
|
|
|
|
end user experience.
|
|
|
|
|
|
|
|
The following description divides
|
|
|
|
the low-level commands into commands that manipulate objects (in
|
2006-10-29 20:09:48 +00:00
|
|
|
the repository, index, and working tree), commands that interrogate and
|
|
|
|
compare objects, and commands that move objects and references between
|
|
|
|
repositories.
|
|
|
|
|
2007-01-19 06:32:38 +00:00
|
|
|
|
2006-10-29 20:09:48 +00:00
|
|
|
Manipulation commands
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-plumbingmanipulators.txt[]
|
2006-10-29 20:09:48 +00:00
|
|
|
|
|
|
|
|
|
|
|
Interrogation commands
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-plumbinginterrogators.txt[]
|
2006-10-29 20:09:48 +00:00
|
|
|
|
|
|
|
In general, the interrogate commands do not touch the files in
|
|
|
|
the working tree.
|
|
|
|
|
|
|
|
|
|
|
|
Synching repositories
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2007-01-18 23:03:13 +00:00
|
|
|
include::cmds-synchingrepositories.txt[]
|
2006-10-29 20:09:48 +00:00
|
|
|
|
2009-08-07 14:24:21 +00:00
|
|
|
The following are helper commands used by the above; end users
|
2007-01-19 06:32:38 +00:00
|
|
|
typically do not use them directly.
|
|
|
|
|
|
|
|
include::cmds-synchelpers.txt[]
|
|
|
|
|
|
|
|
|
|
|
|
Internal helper commands
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
These are internal helper commands used by other commands; end
|
|
|
|
users typically do not use them directly.
|
|
|
|
|
|
|
|
include::cmds-purehelpers.txt[]
|
|
|
|
|
2006-10-29 20:09:48 +00:00
|
|
|
|
2005-10-29 21:32:56 +00:00
|
|
|
Configuration Mechanism
|
|
|
|
-----------------------
|
|
|
|
|
2005-12-08 00:05:21 +00:00
|
|
|
Starting from 0.99.9 (actually mid 0.99.8.GIT), `.git/config` file
|
2005-10-29 21:32:56 +00:00
|
|
|
is used to hold per-repository configuration options. It is a
|
2006-07-09 07:44:30 +00:00
|
|
|
simple text file modeled after `.ini` format familiar to some
|
2005-10-29 21:32:56 +00:00
|
|
|
people. Here is an example:
|
|
|
|
|
|
|
|
------------
|
|
|
|
#
|
2005-12-08 00:05:21 +00:00
|
|
|
# A '#' or ';' character indicates a comment.
|
2005-10-29 21:32:56 +00:00
|
|
|
#
|
|
|
|
|
|
|
|
; core variables
|
|
|
|
[core]
|
|
|
|
; Don't trust file modes
|
|
|
|
filemode = false
|
|
|
|
|
|
|
|
; user identity
|
|
|
|
[user]
|
|
|
|
name = "Junio C Hamano"
|
|
|
|
email = "junkio@twinsun.com"
|
|
|
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
Various commands read from the configuration file and adjust
|
2010-02-14 12:02:35 +00:00
|
|
|
their operation accordingly. See linkgit:git-config[1] for a
|
|
|
|
list.
|
2005-10-29 21:32:56 +00:00
|
|
|
|
|
|
|
|
2005-05-22 17:44:16 +00:00
|
|
|
Identifier Terminology
|
2005-05-10 21:32:30 +00:00
|
|
|
----------------------
|
|
|
|
<object>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates the object name for any type of object.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
<blob>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates a blob object name.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
<tree>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates a tree object name.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
<commit>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates a commit object name.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
<tree-ish>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates a tree, commit or tag object name. A
|
2005-05-22 17:44:16 +00:00
|
|
|
command that takes a <tree-ish> argument ultimately wants to
|
|
|
|
operate on a <tree> object but automatically dereferences
|
|
|
|
<commit> and <tag> objects that point at a <tree>.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2007-03-05 19:46:05 +00:00
|
|
|
<commit-ish>::
|
|
|
|
Indicates a commit or tag object name. A
|
|
|
|
command that takes a <commit-ish> argument ultimately wants to
|
|
|
|
operate on a <commit> object but automatically dereferences
|
|
|
|
<tag> objects that point at a <commit>.
|
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
<type>::
|
|
|
|
Indicates that an object type is required.
|
2005-12-08 00:05:21 +00:00
|
|
|
Currently one of: `blob`, `tree`, `commit`, or `tag`.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
<file>::
|
2005-12-08 00:05:21 +00:00
|
|
|
Indicates a filename - almost always relative to the
|
|
|
|
root of the tree structure `GIT_INDEX_FILE` describes.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
Symbolic Identifiers
|
|
|
|
--------------------
|
2005-08-15 15:23:06 +00:00
|
|
|
Any git command accepting any <object> can also use the following
|
2005-05-22 17:44:16 +00:00
|
|
|
symbolic notation:
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
HEAD::
|
2011-06-23 16:35:10 +00:00
|
|
|
indicates the head of the current branch.
|
2005-12-08 00:05:21 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
<tag>::
|
2005-12-08 00:05:21 +00:00
|
|
|
a valid tag 'name'
|
2011-06-23 16:35:10 +00:00
|
|
|
(i.e. a `refs/tags/<tag>` reference).
|
2005-12-08 00:05:21 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
<head>::
|
2005-12-08 00:05:21 +00:00
|
|
|
a valid head 'name'
|
2011-06-23 16:35:10 +00:00
|
|
|
(i.e. a `refs/heads/<head>` reference).
|
2005-12-08 00:05:21 +00:00
|
|
|
|
2006-10-25 18:33:08 +00:00
|
|
|
For a more complete list of ways to spell object names, see
|
2010-10-11 16:03:32 +00:00
|
|
|
"SPECIFYING REVISIONS" section in linkgit:gitrevisions[7].
|
2006-10-25 18:33:08 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
File/Directory Structure
|
|
|
|
------------------------
|
|
|
|
|
2008-06-30 22:01:21 +00:00
|
|
|
Please see the linkgit:gitrepository-layout[5] document.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
2008-06-30 22:01:21 +00:00
|
|
|
Read linkgit:githooks[5] for more details about each hook.
|
2006-03-25 03:21:07 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
Higher level SCMs may provide and manage additional information in the
|
2005-12-08 00:05:21 +00:00
|
|
|
`$GIT_DIR`.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
2005-09-01 23:56:13 +00:00
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
Terminology
|
|
|
|
-----------
|
2008-06-30 22:01:21 +00:00
|
|
|
Please see linkgit:gitglossary[7].
|
2005-05-10 21:32:30 +00:00
|
|
|
|
|
|
|
|
|
|
|
Environment Variables
|
|
|
|
---------------------
|
|
|
|
Various git commands use the following environment variables:
|
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
The git Repository
|
|
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
These environment variables apply to 'all' core git commands. Nb: it
|
|
|
|
is worth noting that they may be used/overridden by SCMS sitting above
|
2005-12-08 00:05:21 +00:00
|
|
|
git so take care if using Cogito etc.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
'GIT_INDEX_FILE'::
|
|
|
|
This environment allows the specification of an alternate
|
2005-11-11 01:12:27 +00:00
|
|
|
index file. If not specified, the default of `$GIT_DIR/index`
|
|
|
|
is used.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
'GIT_OBJECT_DIRECTORY'::
|
|
|
|
If the object storage directory is specified via this
|
|
|
|
environment variable then the sha1 directories are created
|
|
|
|
underneath - otherwise the default `$GIT_DIR/objects`
|
|
|
|
directory is used.
|
|
|
|
|
|
|
|
'GIT_ALTERNATE_OBJECT_DIRECTORIES'::
|
|
|
|
Due to the immutable nature of git objects, old objects can be
|
|
|
|
archived into shared, read-only directories. This variable
|
2007-12-03 20:55:57 +00:00
|
|
|
specifies a ":" separated (on Windows ";" separated) list
|
|
|
|
of git object directories which can be used to search for git
|
|
|
|
objects. New objects will not be written to these directories.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
'GIT_DIR'::
|
2005-12-08 00:05:21 +00:00
|
|
|
If the 'GIT_DIR' environment variable is set then it
|
|
|
|
specifies a path to use instead of the default `.git`
|
|
|
|
for the base of the repository.
|
2005-05-10 21:32:38 +00:00
|
|
|
|
2007-06-06 07:10:42 +00:00
|
|
|
'GIT_WORK_TREE'::
|
|
|
|
Set the path to the working tree. The value will not be
|
|
|
|
used in combination with repositories found automatically in
|
|
|
|
a .git directory (i.e. $GIT_DIR is not set).
|
|
|
|
This can also be controlled by the '--work-tree' command line
|
|
|
|
option and the core.worktree configuration variable.
|
|
|
|
|
2011-07-08 23:14:10 +00:00
|
|
|
'GIT_NAMESPACE'::
|
|
|
|
Set the git namespace; see linkgit:gitnamespaces[7] for details.
|
|
|
|
The '--namespace' command-line option also sets this value.
|
|
|
|
|
2008-05-20 06:49:26 +00:00
|
|
|
'GIT_CEILING_DIRECTORIES'::
|
|
|
|
This should be a colon-separated list of absolute paths.
|
|
|
|
If set, it is a list of directories that git should not chdir
|
|
|
|
up into while looking for a repository directory.
|
|
|
|
It will not exclude the current working directory or
|
|
|
|
a GIT_DIR set on the command line or in the environment.
|
|
|
|
(Useful for excluding slow-loading network directories.)
|
|
|
|
|
2010-04-04 21:49:31 +00:00
|
|
|
'GIT_DISCOVERY_ACROSS_FILESYSTEM'::
|
2010-04-04 17:33:53 +00:00
|
|
|
When run in a directory that does not have ".git" repository
|
|
|
|
directory, git tries to find such a directory in the parent
|
|
|
|
directories to find the top of the working tree, but by default it
|
|
|
|
does not cross filesystem boundaries. This environment variable
|
2010-04-04 21:49:31 +00:00
|
|
|
can be set to true to tell git not to stop at filesystem
|
|
|
|
boundaries. Like 'GIT_CEILING_DIRECTORIES', this will not affect
|
|
|
|
an explicit repository directory set via 'GIT_DIR' or on the
|
|
|
|
command line.
|
2010-03-17 19:55:53 +00:00
|
|
|
|
2005-05-10 21:32:38 +00:00
|
|
|
git Commits
|
|
|
|
~~~~~~~~~~~
|
|
|
|
'GIT_AUTHOR_NAME'::
|
|
|
|
'GIT_AUTHOR_EMAIL'::
|
|
|
|
'GIT_AUTHOR_DATE'::
|
|
|
|
'GIT_COMMITTER_NAME'::
|
|
|
|
'GIT_COMMITTER_EMAIL'::
|
2007-04-29 01:40:12 +00:00
|
|
|
'GIT_COMMITTER_DATE'::
|
2007-04-29 01:40:28 +00:00
|
|
|
'EMAIL'::
|
2007-12-29 06:20:38 +00:00
|
|
|
see linkgit:git-commit-tree[1]
|
2005-05-10 21:32:38 +00:00
|
|
|
|
|
|
|
git Diffs
|
|
|
|
~~~~~~~~~
|
2005-05-11 03:54:57 +00:00
|
|
|
'GIT_DIFF_OPTS'::
|
2006-11-27 19:37:43 +00:00
|
|
|
Only valid setting is "--unified=??" or "-u??" to set the
|
|
|
|
number of context lines shown when a unified diff is created.
|
|
|
|
This takes precedence over any "-U" or "--unified" option
|
|
|
|
value passed on the git diff command line.
|
|
|
|
|
2005-05-11 03:54:57 +00:00
|
|
|
'GIT_EXTERNAL_DIFF'::
|
2006-11-27 19:37:43 +00:00
|
|
|
When the environment variable 'GIT_EXTERNAL_DIFF' is set, the
|
|
|
|
program named by it is called, instead of the diff invocation
|
|
|
|
described above. For a path that is added, removed, or modified,
|
|
|
|
'GIT_EXTERNAL_DIFF' is called with 7 parameters:
|
|
|
|
|
|
|
|
path old-file old-hex old-mode new-file new-hex new-mode
|
|
|
|
+
|
|
|
|
where:
|
|
|
|
|
|
|
|
<old|new>-file:: are files GIT_EXTERNAL_DIFF can use to read the
|
|
|
|
contents of <old|new>,
|
|
|
|
<old|new>-hex:: are the 40-hexdigit SHA1 hashes,
|
|
|
|
<old|new>-mode:: are the octal representation of the file modes.
|
|
|
|
+
|
|
|
|
The file parameters can point at the user's working file
|
|
|
|
(e.g. `new-file` in "git-diff-files"), `/dev/null` (e.g. `old-file`
|
|
|
|
when a new file is added), or a temporary file (e.g. `old-file` in the
|
|
|
|
index). 'GIT_EXTERNAL_DIFF' should not worry about unlinking the
|
|
|
|
temporary file --- it is removed when 'GIT_EXTERNAL_DIFF' exits.
|
|
|
|
+
|
|
|
|
For a path that is unmerged, 'GIT_EXTERNAL_DIFF' is called with 1
|
|
|
|
parameter, <path>.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2006-06-25 13:56:18 +00:00
|
|
|
other
|
|
|
|
~~~~~
|
2007-07-12 23:54:06 +00:00
|
|
|
'GIT_MERGE_VERBOSITY'::
|
|
|
|
A number controlling the amount of output shown by
|
|
|
|
the recursive merge strategy. Overrides merge.verbosity.
|
2007-12-29 06:20:38 +00:00
|
|
|
See linkgit:git-merge[1]
|
2007-07-12 23:54:06 +00:00
|
|
|
|
2006-07-31 13:27:00 +00:00
|
|
|
'GIT_PAGER'::
|
2007-07-19 10:43:51 +00:00
|
|
|
This environment variable overrides `$PAGER`. If it is set
|
|
|
|
to an empty string or to the value "cat", git will not launch
|
2008-08-24 05:28:32 +00:00
|
|
|
a pager. See also the `core.pager` option in
|
|
|
|
linkgit:git-config[1].
|
2006-07-31 13:27:00 +00:00
|
|
|
|
2012-03-23 12:38:42 +00:00
|
|
|
'GIT_EDITOR'::
|
|
|
|
This environment variable overrides `$EDITOR` and `$VISUAL`.
|
2012-06-19 17:56:09 +00:00
|
|
|
It is used by several git commands when, on interactive mode,
|
2012-03-23 12:38:42 +00:00
|
|
|
an editor is to be launched. See also linkgit:git-var[1]
|
|
|
|
and the `core.editor` option in linkgit:git-config[1].
|
|
|
|
|
2007-08-04 06:06:52 +00:00
|
|
|
'GIT_SSH'::
|
2010-01-09 23:33:00 +00:00
|
|
|
If this environment variable is set then 'git fetch'
|
|
|
|
and 'git push' will use this command instead
|
2008-07-03 05:55:07 +00:00
|
|
|
of 'ssh' when they need to connect to a remote system.
|
2008-06-30 18:56:34 +00:00
|
|
|
The '$GIT_SSH' command will be given exactly two arguments:
|
2007-08-04 06:06:52 +00:00
|
|
|
the 'username@host' (or just 'host') from the URL and the
|
|
|
|
shell command to execute on that remote system.
|
|
|
|
+
|
|
|
|
To pass options to the program that you want to list in GIT_SSH
|
|
|
|
you will need to wrap the program and options into a shell script,
|
|
|
|
then set GIT_SSH to refer to the shell script.
|
|
|
|
+
|
|
|
|
Usually it is easier to configure any desired options through your
|
|
|
|
personal `.ssh/config` file. Please consult your ssh documentation
|
|
|
|
for further details.
|
|
|
|
|
2010-08-30 13:40:29 +00:00
|
|
|
'GIT_ASKPASS'::
|
|
|
|
If this environment variable is set, then git commands which need to
|
|
|
|
acquire passwords or passphrases (e.g. for HTTP or IMAP authentication)
|
|
|
|
will call this program with a suitable prompt as command line argument
|
|
|
|
and read the password from its STDOUT. See also the 'core.askpass'
|
|
|
|
option in linkgit:git-config[1].
|
|
|
|
|
2007-06-29 17:40:46 +00:00
|
|
|
'GIT_FLUSH'::
|
|
|
|
If this environment variable is set to "1", then commands such
|
2010-01-09 23:33:00 +00:00
|
|
|
as 'git blame' (in incremental mode), 'git rev-list', 'git log',
|
|
|
|
and 'git whatchanged' will force a flush of the output stream
|
2007-06-29 17:40:46 +00:00
|
|
|
after each commit-oriented record have been flushed. If this
|
|
|
|
variable is set to "0", the output of these commands will be done
|
|
|
|
using completely buffered I/O. If this environment variable is
|
|
|
|
not set, git will choose buffered or record-oriented flushing
|
|
|
|
based on whether stdout appears to be redirected to a file or not.
|
|
|
|
|
2006-06-25 13:56:18 +00:00
|
|
|
'GIT_TRACE'::
|
2006-09-03 15:32:24 +00:00
|
|
|
If this variable is set to "1", "2" or "true" (comparison
|
|
|
|
is case insensitive), git will print `trace:` messages on
|
2006-06-25 13:56:18 +00:00
|
|
|
stderr telling about alias expansion, built-in command
|
|
|
|
execution and external command execution.
|
2006-09-03 15:32:24 +00:00
|
|
|
If this variable is set to an integer value greater than 1
|
|
|
|
and lower than 10 (strictly) then git will interpret this
|
|
|
|
value as an open file descriptor and will try to write the
|
|
|
|
trace messages into this file descriptor.
|
|
|
|
Alternatively, if this variable is set to an absolute path
|
|
|
|
(starting with a '/' character), git will interpret this
|
|
|
|
as a file path and will try to write the trace messages
|
|
|
|
into it.
|
2006-06-25 13:56:18 +00:00
|
|
|
|
2005-08-30 20:51:01 +00:00
|
|
|
Discussion[[Discussion]]
|
|
|
|
------------------------
|
2007-09-03 04:01:19 +00:00
|
|
|
|
|
|
|
More detail on the following is available from the
|
|
|
|
link:user-manual.html#git-concepts[git concepts chapter of the
|
2008-06-30 22:01:21 +00:00
|
|
|
user-manual] and linkgit:gitcore-tutorial[7].
|
2007-09-03 04:01:19 +00:00
|
|
|
|
|
|
|
A git project normally consists of a working directory with a ".git"
|
|
|
|
subdirectory at the top level. The .git directory contains, among other
|
|
|
|
things, a compressed object database representing the complete history
|
|
|
|
of the project, an "index" file which links that history to the current
|
|
|
|
contents of the working tree, and named pointers into that history such
|
|
|
|
as tags and branch heads.
|
|
|
|
|
|
|
|
The object database contains objects of three main types: blobs, which
|
|
|
|
hold file data; trees, which point to blobs and other trees to build up
|
2007-12-18 06:07:36 +00:00
|
|
|
directory hierarchies; and commits, which each reference a single tree
|
2007-09-03 04:01:19 +00:00
|
|
|
and some number of parent commits.
|
|
|
|
|
|
|
|
The commit, equivalent to what other systems call a "changeset" or
|
|
|
|
"version", represents a step in the project's history, and each parent
|
|
|
|
represents an immediately preceding step. Commits with more than one
|
|
|
|
parent represent merges of independent lines of development.
|
|
|
|
|
|
|
|
All objects are named by the SHA1 hash of their contents, normally
|
|
|
|
written as a string of 40 hex digits. Such names are globally unique.
|
|
|
|
The entire history leading up to a commit can be vouched for by signing
|
|
|
|
just that commit. A fourth object type, the tag, is provided for this
|
|
|
|
purpose.
|
|
|
|
|
|
|
|
When first created, objects are stored in individual files, but for
|
|
|
|
efficiency may later be compressed together into "pack files".
|
|
|
|
|
|
|
|
Named pointers called refs mark interesting points in history. A ref
|
|
|
|
may contain the SHA1 name of an object or the name of another ref. Refs
|
|
|
|
with names beginning `ref/head/` contain the SHA1 name of the most
|
2007-12-18 06:07:36 +00:00
|
|
|
recent commit (or "head") of a branch under development. SHA1 names of
|
2007-09-03 04:01:19 +00:00
|
|
|
tags of interest are stored under `ref/tags/`. A special ref named
|
|
|
|
`HEAD` contains the name of the currently checked-out branch.
|
|
|
|
|
|
|
|
The index file is initialized with a list of all paths and, for each
|
|
|
|
path, a blob object and a set of attributes. The blob object represents
|
|
|
|
the contents of the file as of the head of the current branch. The
|
|
|
|
attributes (last modified time, size, etc.) are taken from the
|
|
|
|
corresponding file in the working tree. Subsequent changes to the
|
|
|
|
working tree can be found by comparing these attributes. The index may
|
|
|
|
be updated with new content, and new commits may be created from the
|
|
|
|
content stored in the index.
|
|
|
|
|
|
|
|
The index is also capable of storing multiple entries (called "stages")
|
|
|
|
for a given pathname. These stages are used to hold the various
|
|
|
|
unmerged version of a file when a merge is in progress.
|
2005-05-22 17:44:16 +00:00
|
|
|
|
2005-11-15 23:31:25 +00:00
|
|
|
Authors
|
|
|
|
-------
|
2011-03-11 05:52:08 +00:00
|
|
|
Git was started by Linus Torvalds, and is currently maintained by Junio
|
|
|
|
C Hamano. Numerous contributions have come from the git mailing list
|
2011-03-13 03:00:38 +00:00
|
|
|
<git@vger.kernel.org>. For a more complete list of contributors, see
|
|
|
|
http://git-scm.com/about. If you have a clone of git.git itself, the
|
|
|
|
output of linkgit:git-shortlog[1] and linkgit:git-blame[1] can show you
|
|
|
|
the authors for specific parts of the project.
|
2005-05-10 21:32:30 +00:00
|
|
|
|
2010-08-02 16:07:39 +00:00
|
|
|
Reporting Bugs
|
|
|
|
--------------
|
|
|
|
|
|
|
|
Report bugs to the Git mailing list <git@vger.kernel.org> where the
|
|
|
|
development and maintenance is primarily done. You do not have to be
|
|
|
|
subscribed to the list to send a message there.
|
|
|
|
|
2008-05-29 17:21:46 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
|
|
|
linkgit:gittutorial[7], linkgit:gittutorial-2[7],
|
2008-08-02 21:41:48 +00:00
|
|
|
link:everyday.html[Everyday Git], linkgit:gitcvs-migration[7],
|
2008-05-29 17:21:46 +00:00
|
|
|
linkgit:gitglossary[7], linkgit:gitcore-tutorial[7],
|
2009-06-06 13:11:07 +00:00
|
|
|
linkgit:gitcli[7], link:user-manual.html[The Git User's Manual],
|
|
|
|
linkgit:gitworkflows[7]
|
2008-05-29 17:21:46 +00:00
|
|
|
|
2005-05-10 21:32:30 +00:00
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|