git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] Clarify commit-tree documentation

From
Mike Hommey <mh@glandium.org>
Date
Aug 17, 2007, 20:13 UTC
Message-ID
<20070817201336.GA20300@glandium.org>
In-Reply-To
<20070817173622.GI28529@fieldses.org>

As per http://marc.info/?l=git&m=118737219702802&w=2 , clarify git-commit-tree documentation.

Signed-off-by: Mike Hommey <mh@glandium.org>
---
 Documentation/git-commit-tree.txt |   15 ++++++---------
 1 files changed, 6 insertions(+), 9 deletions(-)
diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
index 5870c2c..6a328f4 100644
--- a/Documentation/git-commit-tree.txt
+++ b/Documentation/git-commit-tree.txt
@@ -51,9 +51,9 @@ A commit encapsulates:
 - 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 by
-either `.git/config` file, or using the following environment variables.
+While parent object ids are provided on the command line, author and
+commiter information is taken from the following environment variables,
+if set:
 
 	GIT_AUTHOR_NAME
 	GIT_AUTHOR_EMAIL
@@ -65,12 +65,9 @@ either `.git/config` file, or using the following environment variables.
 
 (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"
+In case (some of) these environment variables are not set, the information
+is taken from the configuration items user.name and user.email, or, if not
+present, system user name and fully qualified hostname.
 
 A commit comment is read from stdin. If a changelog
 entry is not provided via "<" redirection, "git-commit-tree" will just wait
-- 
1.5.3.rc4
Previous: J. Bruce FieldsNext: Junio C Hamano
Message 9 of 11 in “Can't figure out some sense from the git-commit-tree man page”
  1. Mike HommeyAug 17, 2007
  2. Johannes SchindelinAug 17, 2007
  3. Mike HommeyAug 17, 2007
  4. Johannes SchindelinAug 17, 2007
  5. Jakub NarebskiAug 17, 2007
  6. J. Bruce FieldsAug 17, 2007
  7. Mike HommeyAug 17, 2007
  8. J. Bruce FieldsAug 17, 2007
  9. Clarify commit-tree documentationMike Hommey, Aug 17, 2007
  10. Junio C HamanoAug 17, 2007
  11. Daniel HulmeAug 17, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.