Documentation/git-commit-tree.txt

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