1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.2.5" />
7 <style type=
"text/css">
9 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
11 border: 1px solid red;
16 margin: 1em 5% 1em 5%;
21 text-decoration: underline
;
39 h1
, h2
, h3
, h4
, h5
, h6
{
41 font-family: sans-serif
;
48 border-bottom: 2px solid silver
;
66 border: 1px solid silver
;
81 font-family: sans-serif
;
88 font-family: sans-serif
;
92 font-family: sans-serif
;
94 border-top: 2px solid silver
;
100 padding-bottom: 0.5em;
104 padding-bottom: 0.5em;
108 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
109 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
110 div
.admonitionblock
{
113 margin-bottom: 1.5em;
115 div
.admonitionblock
{
117 margin-bottom: 2.5em;
120 div
.content
{ /* Block element content. */
124 /* Block element titles. */
125 div
.title
, caption
.title
{
126 font-family: sans-serif
;
130 margin-bottom: 0.5em;
136 td div
.title:first-child
{
139 div
.content div
.title:first-child
{
142 div
.content
+ div
.title
{
146 div
.sidebarblock
> div
.content
{
148 border: 1px solid silver
;
155 div
.listingblock
> div
.content
{
156 border: 1px solid silver
;
161 div
.quoteblock
> div
.content
{
168 div
.verseblock
+ div
.attribution
{
172 div
.admonitionblock
.icon
{
176 text-decoration: underline
;
178 padding-right: 0.5em;
180 div
.admonitionblock td
.content
{
182 border-left: 2px solid silver
;
185 div
.exampleblock
> div
.content
{
186 border-left: 2px solid silver
;
190 div
.verseblock div
.content
{
194 div
.imageblock div
.content
{ padding-left: 0; }
195 div
.imageblock img
{ border: 1px solid silver
; }
196 span
.image img
{ border-style: none
; }
200 margin-bottom: 0.8em;
212 list-style-position: outside
;
215 list-style-type: lower-alpha
;
218 div
.tableblock
> table
{
219 border: 3px solid
#527bbd;
222 font-family: sans-serif
;
231 margin-bottom: 0.8em;
239 padding-right: 0.8em;
246 div#footer-badges
{ display: none
; }
251 font-family: sans-serif
;
255 margin-bottom: 0.1em;
258 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
274 include1::./stylesheets
/xhtml11-manpage
.css
[]
275 /* Workarounds for IE6's broken and incomplete CSS2. */
277 div
.sidebar-content
{
279 border: 1px solid silver
;
282 div
.sidebar-title
, div
.image-title
{
283 font-family: sans-serif
;
286 margin-bottom: 0.5em;
289 div
.listingblock div
.content
{
290 border: 1px solid silver
;
295 div
.quoteblock-content
{
299 div
.exampleblock-content
{
300 border-left: 2px solid silver
;
304 /* IE6 sets dynamically generated links as visited. */
305 div#toc
a:visited
{ color: blue
; }
307 <title>git-annotate(
1)
</title>
312 git-annotate(
1) Manual Page
315 <div class=
"sectionbody">
317 Annotate file lines with commit information
322 <div class=
"sectionbody">
323 <div class=
"para"><p><em>git annotate
</em> [options] file [revision]
</p></div>
325 <h2 id=
"_description">DESCRIPTION
</h2>
326 <div class=
"sectionbody">
327 <div class=
"para"><p>Annotates each line in the given file with information from the commit
328 which introduced the line. Optionally annotates from a given revision.
</p></div>
329 <div class=
"para"><p>The only difference between this command and
<a href=
"git-blame.html">git-blame(
1)
</a> is that
330 they use slightly different output formats, and this command exists only
331 for backward compatibility to support existing scripts, and provide a more
332 familiar command name for people coming from other SCM systems.
</p></div>
334 <h2 id=
"_options">OPTIONS
</h2>
335 <div class=
"sectionbody">
336 <div class=
"vlist"><dl>
342 Show blank SHA-
1 for boundary commits. This can also
343 be controlled via the
<tt>blame.blankboundary
</tt> config option.
351 Do not treat root commits as boundaries. This can also be
352 controlled via the
<tt>blame.showroot
</tt> config option.
360 Include additional statistics at the end of blame output.
364 -L
<start
>,
<end
>
368 Annotate only the given line range.
<start
> and
<end
> can take
371 <div class=
"ilist"><ul>
376 <div class=
"para"><p>If
<start
> or
<end
> is a number, it specifies an
377 absolute line number (lines count from
1).
</p></div>
383 <div class=
"para"><p>This form will use the first line matching the given
384 POSIX regex. If
<end
> is a regex, it will search
385 starting at the line given by
<start
>.
</p></div>
391 <div class=
"para"><p>This is only valid for
<end
> and will specify a number
392 of lines before or after the line given by
<start
>.
</p></div>
401 Show long rev (Default: off).
409 Show raw timestamp (Default: off).
417 Use revisions from revs-file instead of calling
<a href=
"git-rev-list.html">git-rev-list(
1)
</a>.
425 Walk history forward instead of backward. Instead of showing
426 the revision in which a line appeared, this shows the last
427 revision in which a line has existed. This requires a range of
428 revision like START..END where the path to blame exists in
440 Show in a format designed for machine consumption.
448 Show the result incrementally in a format designed for
453 --encoding=
<encoding
>
457 Specifies the encoding used to output author names
458 and commit summaries. Setting it to
<tt>none
</tt> makes blame
459 output unconverted data. For more information see the
460 discussion about encoding in the
<a href=
"git-log.html">git-log(
1)
</a>
465 --contents
<file
>
469 When
<rev
> is not specified, the command annotates the
470 changes starting backwards from the working tree copy.
471 This flag makes the command pretend as if the working
472 tree copy has the contents of the named file (specify
473 <tt>-
</tt> to make the command read from the standard input).
477 --date
<format
>
481 The value is one of the following alternatives:
482 {relative,local,default,iso,rfc,short}. If --date is not
483 provided, the value of the blame.date config variable is
484 used. If the blame.date config variable is also not set, the
485 iso format is used. For more information, See the discussion
486 of the --date option at
<a href=
"git-log.html">git-log(
1)
</a>.
494 Detect moving lines in the file as well. When a commit
495 moves a block of lines in a file (e.g. the original file
496 has A and then B, and the commit changes it to B and
497 then A), the traditional
<em>blame
</em> algorithm typically blames
498 the lines that were moved up (i.e. B) to the parent and
499 assigns blame to the lines that were moved down (i.e. A)
500 to the child commit. With this option, both groups of lines
501 are blamed on the parent.
503 <div class=
"para"><p><num
> is optional but it is the lower bound on the number of
504 alphanumeric characters that git must detect as moving
505 within a file for it to associate those lines with the parent
513 In addition to
<tt>-M
</tt>, detect lines copied from other
514 files that were modified in the same commit. This is
515 useful when you reorganize your program and move code
516 around across files. When this option is given twice,
517 the command additionally looks for copies from all other
518 files in the parent for the commit that creates the file.
520 <div class=
"para"><p><num
> is optional but it is the lower bound on the number of
521 alphanumeric characters that git must detect as moving
522 between files for it to associate those lines with the parent
538 <h2 id=
"_see_also">SEE ALSO
</h2>
539 <div class=
"sectionbody">
540 <div class=
"para"><p><a href=
"git-blame.html">git-blame(
1)
</a></p></div>
542 <h2 id=
"_author">AUTHOR
</h2>
543 <div class=
"sectionbody">
544 <div class=
"para"><p>Written by Ryan Anderson
<ryan@michonline.com
>.
</p></div>
546 <h2 id=
"_git">GIT
</h2>
547 <div class=
"sectionbody">
548 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
551 <div id=
"footer-text">
552 Last updated
2009-
04-
02 06:
49:
44 UTC