X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-commit-tree.txt;h=41d1a1c4b340b17a545feebe9877def8b009933f;hb=162f41292167a800432fc6bbacfcd9f93a90b0c8;hp=55366688136010ff079a502c99a6af9e9b12dc13;hpb=6b7242aa1acc3c7835f80522914ffc4b2e789a29;p=git.git diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt index 55366688..41d1a1c4 100644 --- a/Documentation/git-commit-tree.txt +++ b/Documentation/git-commit-tree.txt @@ -1,6 +1,5 @@ git-commit-tree(1) ================== -v0.1, May 2005 NAME ---- @@ -9,7 +8,7 @@ git-commit-tree - Creates a new commit object SYNOPSIS -------- -'git-commit-tree' [-p ]\ < changelog +'git-commit-tree' [-p ]\* < changelog DESCRIPTION ----------- @@ -27,8 +26,9 @@ 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. +tend to just write the result to the file that is pointed at by +`.git/HEAD`, so that we can always see what the last committed +state was. OPTIONS ------- @@ -36,7 +36,7 @@ OPTIONS An existing tree object -p :: - Each '-p' indicates a the id of a parent commit object. + Each '-p' indicates the id of a parent commit object. Commit Information @@ -49,8 +49,8 @@ A commit encapsulates: - 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. +provide author and committer info. This can be overridden by +either `.git/config` file, or using the following environment variables. GIT_AUTHOR_NAME GIT_AUTHOR_EMAIL @@ -58,11 +58,19 @@ following environment variables. GIT_COMMITTER_NAME GIT_COMMITTER_EMAIL -(nb <,> and '\n's are stripped) +(nb "<", ">" and "\n"s are stripped) + +In `.git/config` file, the following items are used for GIT_AUTHOR_NAME and +GIT_AUTHOR_EMAIL: + + [user] + name = "Your Name" + email = "your@email.address.xz" 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 +entry is not provided via "<" redirection, "git-commit-tree" will just wait +for one to be entered and terminated with ^D. + Diagnostics ----------- @@ -75,7 +83,7 @@ Your sysadmin must hate you!:: See Also -------- -link:git-write-tree.html[git-write-tree] +gitlink:git-write-tree[1] Author @@ -88,5 +96,5 @@ Documentation by David Greaves, Junio C Hamano and the git-list