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.4.5" />
7 <title>git-annotate(
1)
</title>
8 <style type=
"text/css">
10 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
12 border: 1px solid red;
17 margin: 1em 5% 1em 5%;
22 text-decoration: underline
;
42 h1
, h2
, h3
, h4
, h5
, h6
{
44 font-family: sans-serif
;
51 border-bottom: 2px solid silver
;
69 border: 1px solid silver
;
88 font-family: sans-serif
;
94 span#revnumber
, span#revdate
, span#revremark
{
95 font-family: sans-serif
;
99 font-family: sans-serif
;
101 border-top: 2px solid silver
;
107 padding-bottom: 0.5em;
111 padding-bottom: 0.5em;
116 margin-bottom: 1.5em;
118 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
119 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
120 div
.admonitionblock
{
122 margin-bottom: 1.5em;
124 div
.admonitionblock
{
126 margin-bottom: 2.5em;
129 div
.content
{ /* Block element content. */
133 /* Block element titles. */
134 div
.title
, caption
.title
{
136 font-family: sans-serif
;
140 margin-bottom: 0.5em;
146 td div
.title:first-child
{
149 div
.content div
.title:first-child
{
152 div
.content
+ div
.title
{
156 div
.sidebarblock
> div
.content
{
158 border: 1px solid silver
;
162 div
.listingblock
> div
.content
{
163 border: 1px solid silver
;
172 div
.quoteblock
> div
.attribution
{
181 div
.verseblock
> div
.content
{
184 div
.verseblock
> div
.attribution
{
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
189 div
.verseblock
+ div
.attribution
{
193 div
.admonitionblock
.icon
{
197 text-decoration: underline
;
199 padding-right: 0.5em;
201 div
.admonitionblock td
.content
{
203 border-left: 2px solid silver
;
206 div
.exampleblock
> div
.content
{
207 border-left: 2px solid silver
;
211 div
.imageblock div
.content
{ padding-left: 0; }
212 span
.image img
{ border-style: none
; }
213 a
.image:visited
{ color: white
; }
217 margin-bottom: 0.8em;
230 list-style-position: outside
;
233 list-style-type: decimal
;
236 list-style-type: lower-alpha
;
239 list-style-type: upper-alpha
;
242 list-style-type: lower-roman
;
245 list-style-type: upper-roman
;
248 div
.compact ul
, div
.compact ol
,
249 div
.compact p
, div
.compact p
,
250 div
.compact div
, div
.compact div
{
252 margin-bottom: 0.1em;
255 div
.tableblock
> table
{
256 border: 3px solid
#527bbd;
259 font-family: sans-serif
;
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
272 div
.tableblock
> table
[frame
="void"] {
275 div
.tableblock
> table
[frame
="hsides"] {
276 border-left-style: none
;
277 border-right-style: none
;
279 div
.tableblock
> table
[frame
="vsides"] {
280 border-top-style: none
;
281 border-bottom-style: none
;
287 margin-bottom: 0.8em;
290 padding-bottom: 15px;
292 dt
.hdlist1
.strong
, td
.hdlist1
.strong
{
298 padding-right: 0.8em;
304 div
.hdlist
.compact tr
{
314 div#footer-badges
{ display: none
; }
319 font-family: sans-serif
;
323 margin-bottom: 0.1em;
326 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
342 /* Overrides for manpage documents */
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver
;
347 border-bottom: 2px solid silver
;
357 div#toc
{ display: none
; }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
362 div
.sidebar-content
{
364 border: 1px solid silver
;
367 div
.sidebar-title
, div
.image-title
{
369 font-family: sans-serif
;
372 margin-bottom: 0.5em;
375 div
.listingblock div
.content
{
376 border: 1px solid silver
;
381 div
.quoteblock-attribution
{
386 div
.verseblock-content
{
389 div
.verseblock-attribution
{
394 div
.exampleblock-content
{
395 border-left: 2px solid silver
;
399 /* IE6 sets dynamically generated links as visited. */
400 div#toc
a:visited
{ color: blue
; }
406 git-annotate(
1) Manual Page
409 <div class=
"sectionbody">
411 Annotate file lines with commit information
415 <h2 id=
"_synopsis">SYNOPSIS
</h2>
416 <div class=
"sectionbody">
417 <div class=
"paragraph"><p><em>git annotate
</em> [options] file [revision]
</p></div>
419 <h2 id=
"_description">DESCRIPTION
</h2>
420 <div class=
"sectionbody">
421 <div class=
"paragraph"><p>Annotates each line in the given file with information from the commit
422 which introduced the line. Optionally annotates from a given revision.
</p></div>
423 <div class=
"paragraph"><p>The only difference between this command and
<a href=
"git-blame.html">git-blame(
1)
</a> is that
424 they use slightly different output formats, and this command exists only
425 for backward compatibility to support existing scripts, and provide a more
426 familiar command name for people coming from other SCM systems.
</p></div>
428 <h2 id=
"_options">OPTIONS
</h2>
429 <div class=
"sectionbody">
430 <div class=
"dlist"><dl>
436 Show blank SHA-
1 for boundary commits. This can also
437 be controlled via the
<tt>blame.blankboundary
</tt> config option.
445 Do not treat root commits as boundaries. This can also be
446 controlled via the
<tt>blame.showroot
</tt> config option.
454 Include additional statistics at the end of blame output.
458 -L
<start
>,
<end
>
462 Annotate only the given line range.
<start
> and
<end
> can take
465 <div class=
"ulist"><ul>
470 <div class=
"paragraph"><p>If
<start
> or
<end
> is a number, it specifies an
471 absolute line number (lines count from
1).
</p></div>
477 <div class=
"paragraph"><p>This form will use the first line matching the given
478 POSIX regex. If
<end
> is a regex, it will search
479 starting at the line given by
<start
>.
</p></div>
485 <div class=
"paragraph"><p>This is only valid for
<end
> and will specify a number
486 of lines before or after the line given by
<start
>.
</p></div>
495 Show long rev (Default: off).
503 Show raw timestamp (Default: off).
511 Use revisions from revs-file instead of calling
<a href=
"git-rev-list.html">git-rev-list(
1)
</a>.
519 Walk history forward instead of backward. Instead of showing
520 the revision in which a line appeared, this shows the last
521 revision in which a line has existed. This requires a range of
522 revision like START..END where the path to blame exists in
534 Show in a format designed for machine consumption.
542 Show the result incrementally in a format designed for
547 --encoding=
<encoding
>
551 Specifies the encoding used to output author names
552 and commit summaries. Setting it to
<tt>none
</tt> makes blame
553 output unconverted data. For more information see the
554 discussion about encoding in the
<a href=
"git-log.html">git-log(
1)
</a>
559 --contents
<file
>
563 When
<rev
> is not specified, the command annotates the
564 changes starting backwards from the working tree copy.
565 This flag makes the command pretend as if the working
566 tree copy has the contents of the named file (specify
567 <tt>-
</tt> to make the command read from the standard input).
571 --date
<format
>
575 The value is one of the following alternatives:
576 {relative,local,default,iso,rfc,short}. If --date is not
577 provided, the value of the blame.date config variable is
578 used. If the blame.date config variable is also not set, the
579 iso format is used. For more information, See the discussion
580 of the --date option at
<a href=
"git-log.html">git-log(
1)
</a>.
588 Detect moved or copied lines within a file. When a commit
589 moves or copies a block of lines (e.g. the original file
590 has A and then B, and the commit changes it to B and then
591 A), the traditional
<em>blame
</em> algorithm notices only half of
592 the movement and typically blames the lines that were moved
593 up (i.e. B) to the parent and assigns blame to the lines that
594 were moved down (i.e. A) to the child commit. With this
595 option, both groups of lines are blamed on the parent by
596 running extra passes of inspection.
598 <div class=
"paragraph"><p><num
> is optional but it is the lower bound on the number of
599 alphanumeric characters that git must detect as moving/copying
600 within a file for it to associate those lines with the parent
601 commit. The default value is
20.
</p></div>
608 In addition to
<tt>-M
</tt>, detect lines moved or copied from other
609 files that were modified in the same commit. This is
610 useful when you reorganize your program and move code
611 around across files. When this option is given twice,
612 the command additionally looks for copies from other
613 files in the commit that creates the file. When this
614 option is given three times, the command additionally
615 looks for copies from other files in any commit.
617 <div class=
"paragraph"><p><num
> is optional but it is the lower bound on the number of
618 alphanumeric characters that git must detect as moving/copying
619 between files for it to associate those lines with the parent
620 commit. And the default value is
40. If there are more than one
621 <tt>-C
</tt> options given, the
<num
> argument of the last
<tt>-C
</tt> will
622 take effect.
</p></div>
637 <h2 id=
"_see_also">SEE ALSO
</h2>
638 <div class=
"sectionbody">
639 <div class=
"paragraph"><p><a href=
"git-blame.html">git-blame(
1)
</a></p></div>
641 <h2 id=
"_git">GIT
</h2>
642 <div class=
"sectionbody">
643 <div class=
"paragraph"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
646 <div id=
"footer-text">
647 Last updated
2011-
03-
15 23:
30:
13 UTC