git-annotate.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-annotate(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-annotate(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-annotate -
  Annotate file lines with commit info
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <p>git-annotate [options] file [revision]</p>
 </div>
 <h2>DESCRIPTION</h2>
 <div class="sectionbody">
 <p>Annotates each line in the given file with information from the commit
 which introduced the line. Optionally annotate from a given revision.</p>
 </div>
 <h2>OPTIONS</h2>
 <div class="sectionbody">
 <dl>
 <dt>
 -b
 </dt>
 <dd>
 <p>
  Show blank SHA-1 for boundary commits. This can also
  be controlled via the <tt>blame.blankboundary</tt> config option.
 </p>
 </dd>
 <dt>
 --root
 </dt>
 <dd>
 <p>
  Do not treat root commits as boundaries. This can also be
  controlled via the <tt>blame.showroot</tt> config option.
 </p>
 </dd>
 <dt>
 --show-stats
 </dt>
 <dd>
 <p>
  Include additional statistics at the end of blame output.
 </p>
 </dd>
 <dt>
 -L &lt;start&gt;,&lt;end&gt;
 </dt>
 <dd>
 <p>
  Annotate only the given line range. &lt;start&gt; and &lt;end&gt; can take
  one of these forms:
 </p>
 <ul>
 <li>
 <p>
 number
 </p>
 <p>If &lt;start&gt; or &lt;end&gt; is a number, it specifies an
 absolute line number (lines count from 1).</p>
 </li>
 <li>
 <p>
 /regex/
 </p>
 <p>This form will use the first line matching the given
 POSIX regex. If &lt;end&gt; is a regex, it will search
 starting at the line given by &lt;start&gt;.</p>
 </li>
 <li>
 <p>
 +offset or -offset
 </p>
 <p>This is only valid for &lt;end&gt; and will specify a number
 of lines before or after the line given by &lt;start&gt;.</p>
 </li>
 </ul>
 </dd>
 <dt>
 -l
 </dt>
 <dd>
 <p>
  Show long rev (Default: off).
 </p>
 </dd>
 <dt>
 -t
 </dt>
 <dd>
 <p>
  Show raw timestamp (Default: off).
 </p>
 </dd>
 <dt>
 -S &lt;revs-file&gt;
 </dt>
 <dd>
 <p>
  Use revs from revs-file instead of calling <a href="git-rev-list.html">git-rev-list(1)</a>.
 </p>
 </dd>
 <dt>
 -p, --porcelain
 </dt>
 <dd>
 <p>
  Show in a format designed for machine consumption.
 </p>
 </dd>
 <dt>
 --incremental
 </dt>
 <dd>
 <p>
  Show the result incrementally in a format designed for
  machine consumption.
 </p>
 </dd>
 <dt>
 --contents &lt;file&gt;
 </dt>
 <dd>
 <p>
  When &lt;rev&gt; is not specified, the command annotates the
  changes starting backwards from the working tree copy.
  This flag makes the command pretend as if the working
  tree copy has the contents of the named file (specify
  <tt>-</tt> to make the command read from the standard input).
 </p>
 </dd>
 <dt>
 -M|&lt;num&gt;|
 </dt>
 <dd>
 <p>
  Detect moving lines in the file as well. When a commit
  moves a block of lines in a file (e.g. the original file
  has A and then B, and the commit changes it to B and
  then A), traditional <em>blame</em> algorithm typically blames
  the lines that were moved up (i.e. B) to the parent and
  assigns blame to the lines that were moved down (i.e. A)
  to the child commit. With this option, both groups of lines
  are blamed on the parent.
 </p>
 <p>&lt;num&gt; is optional but it is the lower bound on the number of
 alphanumeric characters that git must detect as moving
 within a file for it to associate those lines with the parent
 commit.</p>
 </dd>
 <dt>
 -C|&lt;num&gt;|
 </dt>
 <dd>
 <p>
  In addition to <tt>-M</tt>, detect lines copied from other
  files that were modified in the same commit. This is
  useful when you reorganize your program and move code
  around across files. When this option is given twice,
  the command looks for copies from all other files in the
  parent for the commit that creates the file in addition.
 </p>
 <p>&lt;num&gt; is optional but it is the lower bound on the number of
 alphanumeric characters that git must detect as moving
 between files for it to associate those lines with the parent
 commit.</p>
 </dd>
 <dt>
 -h, --help
 </dt>
 <dd>
 <p>
  Show help message.
 </p>
 </dd>
 </dl>
 </div>
 <h2>SEE ALSO</h2>
 <div class="sectionbody">
 <p><a href="git-blame.html">git-blame(1)</a></p>
 </div>
 <h2>AUTHOR</h2>
 <div class="sectionbody">
 <p>Written by Ryan Anderson &lt;ryan@michonline.com&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 10-Feb-2008 10:47:41 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-annotate(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-annotate(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-annotate -
	Annotate file lines with commit info
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<p>git-annotate [options] file [revision]</p>
	</div>
	<h2>DESCRIPTION</h2>
	<div class="sectionbody">
	<p>Annotates each line in the given file with information from the commit
	which introduced the line. Optionally annotate from a given revision.</p>
	</div>
	<h2>OPTIONS</h2>
	<div class="sectionbody">
	<dl>
	<dt>
	-b
	</dt>
	<dd>
	<p>
	Show blank SHA-1 for boundary commits. This can also
	be controlled via the <tt>blame.blankboundary</tt> config option.
	</p>
	</dd>
	<dt>
	--root
	</dt>
	<dd>
	<p>
	Do not treat root commits as boundaries. This can also be
	controlled via the <tt>blame.showroot</tt> config option.
	</p>
	</dd>
	<dt>
	--show-stats
	</dt>
	<dd>
	<p>
	Include additional statistics at the end of blame output.
	</p>
	</dd>
	<dt>
	-L <start>,<end>
	</dt>
	<dd>
	<p>
	Annotate only the given line range. <start> and <end> can take
	one of these forms:
	</p>
	<ul>
	<li>
	<p>
	number
	</p>
	<p>If <start> or <end> is a number, it specifies an
	absolute line number (lines count from 1).</p>
	</li>
	<li>
	<p>
	/regex/
	</p>
	<p>This form will use the first line matching the given
	POSIX regex. If <end> is a regex, it will search
	starting at the line given by <start>.</p>
	</li>
	<li>
	<p>
	+offset or -offset
	</p>
	<p>This is only valid for <end> and will specify a number
	of lines before or after the line given by <start>.</p>
	</li>
	</ul>
	</dd>
	<dt>
	-l
	</dt>
	<dd>
	<p>
	Show long rev (Default: off).
	</p>
	</dd>
	<dt>
	-t
	</dt>
	<dd>
	<p>
	Show raw timestamp (Default: off).
	</p>
	</dd>
	<dt>
	-S <revs-file>
	</dt>
	<dd>
	<p>
	Use revs from revs-file instead of calling <a href="git-rev-list.html">git-rev-list(1)</a>.
	</p>
	</dd>
	<dt>
	-p, --porcelain
	</dt>
	<dd>
	<p>
	Show in a format designed for machine consumption.
	</p>
	</dd>
	<dt>
	--incremental
	</dt>
	<dd>
	<p>
	Show the result incrementally in a format designed for
	machine consumption.
	</p>
	</dd>
	<dt>
	--contents <file>
	</dt>
	<dd>
	<p>
	When <rev> is not specified, the command annotates the
	changes starting backwards from the working tree copy.
	This flag makes the command pretend as if the working
	tree copy has the contents of the named file (specify
	<tt>-</tt> to make the command read from the standard input).
	</p>
	</dd>
	<dt>
	-M\|<num>\|
	</dt>
	<dd>
	<p>
	Detect moving lines in the file as well. When a commit
	moves a block of lines in a file (e.g. the original file
	has A and then B, and the commit changes it to B and
	then A), traditional <em>blame</em> algorithm typically blames
	the lines that were moved up (i.e. B) to the parent and
	assigns blame to the lines that were moved down (i.e. A)
	to the child commit. With this option, both groups of lines
	are blamed on the parent.
	</p>
	<p><num> is optional but it is the lower bound on the number of
	alphanumeric characters that git must detect as moving
	within a file for it to associate those lines with the parent
	commit.</p>
	</dd>
	<dt>
	-C\|<num>\|
	</dt>
	<dd>
	<p>
	In addition to <tt>-M</tt>, detect lines copied from other
	files that were modified in the same commit. This is
	useful when you reorganize your program and move code
	around across files. When this option is given twice,
	the command looks for copies from all other files in the
	parent for the commit that creates the file in addition.
	</p>
	<p><num> is optional but it is the lower bound on the number of
	alphanumeric characters that git must detect as moving
	between files for it to associate those lines with the parent
	commit.</p>
	</dd>
	<dt>
	-h, --help
	</dt>
	<dd>
	<p>
	Show help message.
	</p>
	</dd>
	</dl>
	</div>
	<h2>SEE ALSO</h2>
	<div class="sectionbody">
	<p><a href="git-blame.html">git-blame(1)</a></p>
	</div>
	<h2>AUTHOR</h2>
	<div class="sectionbody">
	<p>Written by Ryan Anderson <ryan@michonline.com>.</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 10-Feb-2008 10:47:41 UTC
	</div>
	</div>
	</body>
	</html>