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 moved or copied lines within a file. When a commit
495 moves or copies a block of lines (e.g. the original file
496 has A and then B, and the commit changes it to B and then
497 A), the traditional
<em>blame
</em> algorithm notices only half of
498 the movement and typically blames the lines that were moved
499 up (i.e. B) to the parent and assigns blame to the lines that
500 were moved down (i.e. A) to the child commit. With this
501 option, both groups of lines are blamed on the parent by
502 running extra passes of inspection.
504 <div class=
"para"><p><num
> is optional but it is the lower bound on the number of
505 alphanumeric characters that git must detect as moving/copying
506 within a file for it to associate those lines with the parent
507 commit. The default value is
20.
</p></div>
514 In addition to
<tt>-M
</tt>, detect lines moved or copied from other
515 files that were modified in the same commit. This is
516 useful when you reorganize your program and move code
517 around across files. When this option is given twice,
518 the command additionally looks for copies from other
519 files in the commit that creates the file. When this
520 option is given three times, the command additionally
521 looks for copies from other files in any commit.
523 <div class=
"para"><p><num
> is optional but it is the lower bound on the number of
524 alphanumeric characters that git must detect as moving/copying
525 between files for it to associate those lines with the parent
526 commit. And the default value is
40. If there are more than one
527 <tt>-C
</tt> options given, the
<num
> argument of the last
<tt>-C
</tt> will
528 take effect.
</p></div>
543 <h2 id=
"_see_also">SEE ALSO
</h2>
544 <div class=
"sectionbody">
545 <div class=
"para"><p><a href=
"git-blame.html">git-blame(
1)
</a></p></div>
547 <h2 id=
"_author">AUTHOR
</h2>
548 <div class=
"sectionbody">
549 <div class=
"para"><p>Written by Ryan Anderson
<ryan@michonline.com
>.
</p></div>
551 <h2 id=
"_git">GIT
</h2>
552 <div class=
"sectionbody">
553 <div class=
"para"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
556 <div id=
"footer-text">
557 Last updated
2010-
09-
18 23:
56:
33 UTC