path: root/Documentation/git-commit-tree.txt
diff options
Diffstat (limited to 'Documentation/git-commit-tree.txt')
1 files changed, 81 insertions, 0 deletions
diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
new file mode 100644
index 0000000..5552050
--- /dev/null
+++ b/Documentation/git-commit-tree.txt
@@ -0,0 +1,81 @@
+v0.1, May 2005
+git-commit-tree - Creates a new commit object
+'git-commit-tree' <tree> [-p <parent commit>]\ < changelog
+Creates a new commit object based on the provided tree object and
+emits the new commit object id on stdout. If no parent is given then
+it is considered to be an initial tree.
+A commit object usually has 1 parent (a commit after a change) or up
+to 16 parents. More than one parent represents a merge of branches
+that led to them.
+While a tree represents a particular directory state of a working
+directory, a commit represents that state in "time", and explains how
+to get there.
+Normally a commit would identify a new "HEAD" state, and while git
+doesn't care where you save the note about that state, in practice we
+tend to just write the result to the file `.git/HEAD`, so that we can
+always see what the last committed state was.
+ An existing tree object
+-p <parent commit>::
+ Each '-p' indicates a the id of a parent commit object.
+Commit Information
+A commit encapsulates:
+- all parent object ids
+- author name, email and date
+- committer name and email and the commit time.
+If not provided, "git-commit-tree" uses your name, hostname and domain to
+provide author and committer info. This can be overridden using the
+following environment variables.
+(nb <,> and '\n's are stripped)
+A commit comment is read from stdin (max 999 chars). If a changelog
+entry is not provided via '<' redirection, "git-commit-tree" will just wait
+for one to be entered and terminated with ^D
+see also: link:git-write-tree.html[git-write-tree]
+Written by Linus Torvalds <>
+Documentation by David Greaves, Junio C Hamano and the git-list <>.
+Part of the link:git.html[git] suite