git-commit-tree.html - external/gitster/git-htmldocs - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 7.0.2" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
 /*
  border: 1px solid red;
 */
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a { color: blue; }
 a:visited { color: fuchsia; }

 em {
  font-style: italic;
 }

 strong {
  font-weight: bold;
 }

 tt {
  color: navy;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1 {
  border-bottom: 2px solid silver;
 }
 h2 {
  border-bottom: 2px solid silver;
  padding-top: 0.5em;
 }

 div.sectionbody {
  font-family: serif;
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 pre {
  padding: 0;
  margin: 0;
 }

 span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.2em;
 }
 span#email {
 }
 span#revision {
  font-family: sans-serif;
 }

 div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 div#footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 div#preamble,
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }

 div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock > div.content {
  padding-left: 2.0em;
 }
 div.quoteblock .attribution {
  text-align: right;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
 }

 div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
 }

 div.verseblock div.content {
  white-space: pre;
 }

 div.imageblock div.content { padding-left: 0; }
 div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
 }
 dd > *:first-child {
  margin-top: 0;
 }

 ul, ol {
  list-style-position: outside;
 }
 ol.olist2 {
  list-style-type: lower-alpha;
 }

 div.tableblock > table {
  border-color: #527bbd;
  border-width: 3px;
 }
 thead {
  font-family: sans-serif;
  font-weight: bold;
 }
 tfoot {
  font-weight: bold;
 }

 div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
 }
 td.hlist2 {
  vertical-align: top;
 }

 @media print {
  div#footer-badges { display: none; }
 }
 include::./stylesheets/xhtml11-manpage.css[]
 /* Workarounds for IE6's broken and incomplete CSS2. */

 div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }
 div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
 }

 div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock-content {
  padding-left: 2.0em;
 }

 div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
 }
 </style>
 <title>git-commit-tree(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-commit-tree(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-commit-tree -
  Creates a new commit object
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <p><em>git-commit-tree</em> &lt;tree&gt; [-p &lt;parent commit&gt;]* &lt; changelog</p>
 </div>
 <h2>DESCRIPTION</h2>
 <div class="sectionbody">
 <p>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.</p>
 <p>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.</p>
 <p>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.</p>
 <p>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 that is pointed at by
 <tt>.git/HEAD</tt>, so that we can always see what the last committed
 state was.</p>
 </div>
 <h2>OPTIONS</h2>
 <div class="sectionbody">
 <dl>
 <dt>
 &lt;tree&gt;
 </dt>
 <dd>
 <p>
  An existing tree object
 </p>
 </dd>
 <dt>
 -p &lt;parent commit&gt;
 </dt>
 <dd>
 <p>
  Each <em>-p</em> indicates the id of a parent commit object.
 </p>
 </dd>
 </dl>
 </div>
 <h2>Commit Information</h2>
 <div class="sectionbody">
 <p>A commit encapsulates:</p>
 <ul>
 <li>
 <p>
 all parent object ids
 </p>
 </li>
 <li>
 <p>
 author name, email and date
 </p>
 </li>
 <li>
 <p>
 committer name and email and the commit time.
 </p>
 </li>
 </ul>
 <p>If not provided, "git-commit-tree" uses your name, hostname and domain to
 provide author and committer info. This can be overridden by
 either <tt>.git/config</tt> file, or using the following environment variables.</p>
 <div class="literalblock">
 <div class="content">
 <pre><tt>GIT_AUTHOR_NAME
 GIT_AUTHOR_EMAIL
 GIT_AUTHOR_DATE
 GIT_COMMITTER_NAME
 GIT_COMMITTER_EMAIL</tt></pre>
 </div></div>
 <p>(nb "&lt;", "&gt;" and "\n"s are stripped)</p>
 <p>In <tt>.git/config</tt> file, the following items are used for GIT_AUTHOR_NAME and
 GIT_AUTHOR_EMAIL:</p>
 <div class="literalblock">
 <div class="content">
 <pre><tt>[user]
  name = "Your Name"
  email = "your@email.address.xz"</tt></pre>
 </div></div>
 <p>A commit comment is read from stdin (max 999 chars). If a changelog
 entry is not provided via "&lt;" redirection, "git-commit-tree" will just wait
 for one to be entered and terminated with ^D.</p>
 </div>
 <h2>Diagnostics</h2>
 <div class="sectionbody">
 <dl>
 <dt>
 You don't exist. Go away!
 </dt>
 <dd>
 <p>
  The passwd(5) gecos field couldn't be read
 </p>
 </dd>
 <dt>
 Your parents must have hated you!
 </dt>
 <dd>
 <p>
  The password(5) gecos field is longer than a giant static buffer.
 </p>
 </dd>
 <dt>
 Your sysadmin must hate you!
 </dt>
 <dd>
 <p>
  The password(5) name field is longer than a giant static buffer.
 </p>
 </dd>
 </dl>
 </div>
 <h2>See Also</h2>
 <div class="sectionbody">
 <p><a href="git-write-tree.html">git-write-tree(1)</a></p>
 </div>
 <h2>Author</h2>
 <div class="sectionbody">
 <p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>
 </div>
 <h2>Documentation</h2>
 <div class="sectionbody">
 <p>Documentation by David Greaves, Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>
 <h2>GIT</h2>
 <div class="sectionbody">
 <p>Part of the <a href="git.html">git(7)</a> suite</p>
 </div>
 <div id="footer">
 <div id="footer-text">
 Last updated 03-Oct-2006 08:40:57 UTC
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="generator" content="AsciiDoc 7.0.2" />
	<style type="text/css">
	/* Debug borders */
	p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
	/*
	border: 1px solid red;
	*/
	}

	body {
	margin: 1em 5% 1em 5%;
	}

	a { color: blue; }
	a:visited { color: fuchsia; }

	em {
	font-style: italic;
	}

	strong {
	font-weight: bold;
	}

	tt {
	color: navy;
	}

	h1, h2, h3, h4, h5, h6 {
	color: #527bbd;
	font-family: sans-serif;
	margin-top: 1.2em;
	margin-bottom: 0.5em;
	line-height: 1.3;
	}

	h1 {
	border-bottom: 2px solid silver;
	}
	h2 {
	border-bottom: 2px solid silver;
	padding-top: 0.5em;
	}

	div.sectionbody {
	font-family: serif;
	margin-left: 0;
	}

	hr {
	border: 1px solid silver;
	}

	p {
	margin-top: 0.5em;
	margin-bottom: 0.5em;
	}

	pre {
	padding: 0;
	margin: 0;
	}

	span#author {
	color: #527bbd;
	font-family: sans-serif;
	font-weight: bold;
	font-size: 1.2em;
	}
	span#email {
	}
	span#revision {
	font-family: sans-serif;
	}

	div#footer {
	font-family: sans-serif;
	font-size: small;
	border-top: 2px solid silver;
	padding-top: 0.5em;
	margin-top: 4.0em;
	}
	div#footer-text {
	float: left;
	padding-bottom: 0.5em;
	}
	div#footer-badges {
	float: right;
	padding-bottom: 0.5em;
	}

	div#preamble,
	div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
	div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
	div.admonitionblock {
	margin-right: 10%;
	margin-top: 1.5em;
	margin-bottom: 1.5em;
	}
	div.admonitionblock {
	margin-top: 2.5em;
	margin-bottom: 2.5em;
	}

	div.content { /* Block element content. */
	padding: 0;
	}

	/* Block element titles. */
	div.title, caption.title {
	font-family: sans-serif;
	font-weight: bold;
	text-align: left;
	margin-top: 1.0em;
	margin-bottom: 0.5em;
	}
	div.title + * {
	margin-top: 0;
	}

	td div.title:first-child {
	margin-top: 0.0em;
	}
	div.content div.title:first-child {
	margin-top: 0.0em;
	}
	div.content + div.title {
	margin-top: 0.0em;
	}

	div.sidebarblock > div.content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}

	div.listingblock > div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock > div.content {
	padding-left: 2.0em;
	}
	div.quoteblock .attribution {
	text-align: right;
	}

	div.admonitionblock .icon {
	vertical-align: top;
	font-size: 1.1em;
	font-weight: bold;
	text-decoration: underline;
	color: #527bbd;
	padding-right: 0.5em;
	}
	div.admonitionblock td.content {
	padding-left: 0.5em;
	border-left: 2px solid silver;
	}

	div.exampleblock > div.content {
	border-left: 2px solid silver;
	padding: 0.5em;
	}

	div.verseblock div.content {
	white-space: pre;
	}

	div.imageblock div.content { padding-left: 0; }
	div.imageblock img { border: 1px solid silver; }
	span.image img { border-style: none; }

	dl {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	dt {
	margin-top: 0.5em;
	margin-bottom: 0;
	font-style: italic;
	}
	dd > *:first-child {
	margin-top: 0;
	}

	ul, ol {
	list-style-position: outside;
	}
	ol.olist2 {
	list-style-type: lower-alpha;
	}

	div.tableblock > table {
	border-color: #527bbd;
	border-width: 3px;
	}
	thead {
	font-family: sans-serif;
	font-weight: bold;
	}
	tfoot {
	font-weight: bold;
	}

	div.hlist {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	td.hlist1 {
	vertical-align: top;
	font-style: italic;
	padding-right: 0.8em;
	}
	td.hlist2 {
	vertical-align: top;
	}

	@media print {
	div#footer-badges { display: none; }
	}
	include::./stylesheets/xhtml11-manpage.css[]
	/* Workarounds for IE6's broken and incomplete CSS2. */

	div.sidebar-content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}
	div.sidebar-title, div.image-title {
	font-family: sans-serif;
	font-weight: bold;
	margin-top: 0.0em;
	margin-bottom: 0.5em;
	}

	div.listingblock div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock-content {
	padding-left: 2.0em;
	}

	div.exampleblock-content {
	border-left: 2px solid silver;
	padding-left: 0.5em;
	}
	</style>
	<title>git-commit-tree(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-commit-tree(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-commit-tree -
	Creates a new commit object
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<p><em>git-commit-tree</em> <tree> [-p <parent commit>]* < changelog</p>
	</div>
	<h2>DESCRIPTION</h2>
	<div class="sectionbody">
	<p>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.</p>
	<p>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.</p>
	<p>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.</p>
	<p>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 that is pointed at by
	<tt>.git/HEAD</tt>, so that we can always see what the last committed
	state was.</p>
	</div>
	<h2>OPTIONS</h2>
	<div class="sectionbody">
	<dl>
	<dt>
	<tree>
	</dt>
	<dd>
	<p>
	An existing tree object
	</p>
	</dd>
	<dt>
	-p <parent commit>
	</dt>
	<dd>
	<p>
	Each <em>-p</em> indicates the id of a parent commit object.
	</p>
	</dd>
	</dl>
	</div>
	<h2>Commit Information</h2>
	<div class="sectionbody">
	<p>A commit encapsulates:</p>
	<ul>
	<li>
	<p>
	all parent object ids
	</p>
	</li>
	<li>
	<p>
	author name, email and date
	</p>
	</li>
	<li>
	<p>
	committer name and email and the commit time.
	</p>
	</li>
	</ul>
	<p>If not provided, "git-commit-tree" uses your name, hostname and domain to
	provide author and committer info. This can be overridden by
	either <tt>.git/config</tt> file, or using the following environment variables.</p>
	<div class="literalblock">
	<div class="content">
	<pre><tt>GIT_AUTHOR_NAME
	GIT_AUTHOR_EMAIL
	GIT_AUTHOR_DATE
	GIT_COMMITTER_NAME
	GIT_COMMITTER_EMAIL</tt></pre>
	</div></div>
	<p>(nb "<", ">" and "\n"s are stripped)</p>
	<p>In <tt>.git/config</tt> file, the following items are used for GIT_AUTHOR_NAME and
	GIT_AUTHOR_EMAIL:</p>
	<div class="literalblock">
	<div class="content">
	<pre><tt>[user]
	name = "Your Name"
	email = "your@email.address.xz"</tt></pre>
	</div></div>
	<p>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.</p>
	</div>
	<h2>Diagnostics</h2>
	<div class="sectionbody">
	<dl>
	<dt>
	You don't exist. Go away!
	</dt>
	<dd>
	<p>
	The passwd(5) gecos field couldn't be read
	</p>
	</dd>
	<dt>
	Your parents must have hated you!
	</dt>
	<dd>
	<p>
	The password(5) gecos field is longer than a giant static buffer.
	</p>
	</dd>
	<dt>
	Your sysadmin must hate you!
	</dt>
	<dd>
	<p>
	The password(5) name field is longer than a giant static buffer.
	</p>
	</dd>
	</dl>
	</div>
	<h2>See Also</h2>
	<div class="sectionbody">
	<p><a href="git-write-tree.html">git-write-tree(1)</a></p>
	</div>
	<h2>Author</h2>
	<div class="sectionbody">
	<p>Written by Linus Torvalds <torvalds@osdl.org></p>
	</div>
	<h2>Documentation</h2>
	<div class="sectionbody">
	<p>Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.</p>
	</div>
	<h2>GIT</h2>
	<div class="sectionbody">
	<p>Part of the <a href="git.html">git(7)</a> suite</p>
	</div>
	<div id="footer">
	<div id="footer-text">
	Last updated 03-Oct-2006 08:40:57 UTC
	</div>
	</div>
	</body>
	</html>