~ubuntu-branches/ubuntu/edgy/git-core/edgy-backports

« back to all changes in this revision

Viewing changes to Documentation/git-commit-tree.txt

  • Committer: Package Import Robot
  • Author(s): LaMont Jones
  • Date: 2007-11-29 07:28:44 UTC
  • mfrom: (8.1.2 dapper-backports)
  • Revision ID: package-import@ubuntu.com-20071129072844-umsb7y3140yhxkth
Tags: 1:1.5.3.6-1.1~dapper1
* backport to dapper et al.
  - debian/rules changes to support source:Upstream-Version for old dpkg.
  - allow asciidoc (>7.0.2-3)

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
 
4
4
NAME
5
5
----
6
 
git-commit-tree - Creates a new commit object
 
6
git-commit-tree - Create a new commit object
7
7
 
8
8
 
9
9
SYNOPSIS
12
12
 
13
13
DESCRIPTION
14
14
-----------
 
15
This is usually not what an end user wants to run directly.  See
 
16
gitlink:git-commit[1] instead.
 
17
 
15
18
Creates a new commit object based on the provided tree object and
16
19
emits the new commit object id on stdout. If no parent is given then
17
20
it is considered to be an initial tree.
37
40
 
38
41
-p <parent commit>::
39
42
        Each '-p' indicates the id of a parent commit object.
40
 
        
 
43
 
41
44
 
42
45
Commit Information
43
46
------------------
48
51
- author name, email and date
49
52
- committer name and email and the commit time.
50
53
 
51
 
If not provided, "git-commit-tree" uses your name, hostname and domain to
52
 
provide author and committer info. This can be overridden by
53
 
either `.git/config` file, or using the following environment variables.
 
54
While parent object ids are provided on the command line, author and
 
55
committer information is taken from the following environment variables,
 
56
if set:
54
57
 
55
58
        GIT_AUTHOR_NAME
56
59
        GIT_AUTHOR_EMAIL
57
60
        GIT_AUTHOR_DATE
58
61
        GIT_COMMITTER_NAME
59
62
        GIT_COMMITTER_EMAIL
 
63
        GIT_COMMITTER_DATE
 
64
        EMAIL
60
65
 
61
66
(nb "<", ">" and "\n"s are stripped)
62
67
 
63
 
In `.git/config` file, the following items are used for GIT_AUTHOR_NAME and
64
 
GIT_AUTHOR_EMAIL:
65
 
 
66
 
        [user]
67
 
                name = "Your Name"
68
 
                email = "your@email.address.xz"
69
 
 
70
 
A commit comment is read from stdin (max 999 chars). If a changelog
 
68
In case (some of) these environment variables are not set, the information
 
69
is taken from the configuration items user.name and user.email, or, if not
 
70
present, system user name and fully qualified hostname.
 
71
 
 
72
A commit comment is read from stdin. If a changelog
71
73
entry is not provided via "<" redirection, "git-commit-tree" will just wait
72
74
for one to be entered and terminated with ^D.
73
75
 
81
83
Your sysadmin must hate you!::
82
84
    The password(5) name field is longer than a giant static buffer.
83
85
 
 
86
Discussion
 
87
----------
 
88
 
 
89
include::i18n.txt[]
 
90
 
84
91
See Also
85
92
--------
86
93
gitlink:git-write-tree[1]
97
104
GIT
98
105
---
99
106
Part of the gitlink:git[7] suite
100