1git-commit-tree(1) 2================== 3 4NAME 5---- 6git-commit-tree - Creates a new commit object 7 8 9SYNOPSIS 10-------- 11'git-commit-tree' <tree> [-p <parent commit>]\ < changelog 12 13DESCRIPTION 14----------- 15Creates a new commit object based on the provided tree object and 16emits the new commit object id on stdout. If no parent is given then 17it is considered to be an initial tree. 18 19A commit object usually has 1 parent (a commit after a change) or up 20to 16 parents. More than one parent represents a merge of branches 21that led to them. 22 23While a tree represents a particular directory state of a working 24directory, a commit represents that state in "time", and explains how 25to get there. 26 27Normally a commit would identify a new "HEAD" state, and while git 28doesn't care where you save the note about that state, in practice we 29tend to just write the result to the file `.git/HEAD`, so that we can 30always see what the last committed state was. 31 32OPTIONS 33------- 34<tree>:: 35 An existing tree object 36 37-p <parent commit>:: 38 Each '-p' indicates the id of a parent commit object. 39 40 41Commit Information 42------------------ 43 44A commit encapsulates: 45 46- all parent object ids 47- author name, email and date 48- committer name and email and the commit time. 49 50If not provided, "git-commit-tree" uses your name, hostname and domain to 51provide author and committer info. This can be overridden by 52either `.git/config` file, or using the following environment variables. 53 54 GIT_AUTHOR_NAME 55 GIT_AUTHOR_EMAIL 56 GIT_AUTHOR_DATE 57 GIT_COMMITTER_NAME 58 GIT_COMMITTER_EMAIL 59 60(nb "<", ">" and "\n"s are stripped) 61 62In `.git/config` file, the following items are used: 63 64 [user] 65 name = "Your Name" 66 email = "your@email.address.xz" 67 68A commit comment is read from stdin (max 999 chars). If a changelog 69entry is not provided via "<" redirection, "git-commit-tree" will just wait 70for one to be entered and terminated with ^D. 71 72 73Diagnostics 74----------- 75You don't exist. Go away!:: 76 The passwd(5) gecos field couldn't be read 77Your parents must have hated you!:: 78 The password(5) gecos field is longer than a giant static buffer. 79Your sysadmin must hate you!:: 80 The password(5) name field is longer than a giant static buffer. 81 82See Also 83-------- 84gitlink:git-write-tree[1] 85 86 87Author 88------ 89Written by Linus Torvalds <torvalds@osdl.org> 90 91Documentation 92-------------- 93Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 94 95GIT 96--- 97Part of the gitlink:git[7] suite 98