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