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