]>
Commit | Line | Data |
---|---|---|
635f4a30 AR |
1 | -b:: |
2 | Show blank SHA-1 for boundary commits. This can also | |
3 | be controlled via the `blame.blankboundary` config option. | |
4 | ||
5 | --root:: | |
6 | Do not treat root commits as boundaries. This can also be | |
da0005b8 | 7 | controlled via the `blame.showRoot` config option. |
635f4a30 AR |
8 | |
9 | --show-stats:: | |
10 | Include additional statistics at the end of blame output. | |
11 | ||
e6d2b9f6 | 12 | -L <start>,<end>:: |
d349e0ee | 13 | -L :<funcname>:: |
5bd9b79a ES |
14 | Annotate only the given line range. May be specified multiple times. |
15 | Overlapping ranges are allowed. | |
16 | + | |
17 | <start> and <end> are optional. ``-L <start>'' or ``-L <start>,'' spans from | |
18 | <start> to end of file. ``-L ,<end>'' spans from start of file to <end>. | |
df83d5cf | 19 | + |
25ed3412 | 20 | include::line-range-format.txt[] |
635f4a30 AR |
21 | |
22 | -l:: | |
23 | Show long rev (Default: off). | |
24 | ||
25 | -t:: | |
26 | Show raw timestamp (Default: off). | |
27 | ||
28 | -S <revs-file>:: | |
b89510f0 | 29 | Use revisions from revs-file instead of calling linkgit:git-rev-list[1]. |
635f4a30 | 30 | |
e1d09701 | 31 | --reverse <rev>..<rev>:: |
b452cc16 MM |
32 | Walk history forward instead of backward. Instead of showing |
33 | the revision in which a line appeared, this shows the last | |
34 | revision in which a line has existed. This requires a range of | |
35 | revision like START..END where the path to blame exists in | |
e1d09701 JH |
36 | START. `git blame --reverse START` is taken as `git blame |
37 | --reverse START..HEAD` for convenience. | |
b452cc16 | 38 | |
3240240f SB |
39 | -p:: |
40 | --porcelain:: | |
635f4a30 AR |
41 | Show in a format designed for machine consumption. |
42 | ||
ed747dd5 JK |
43 | --line-porcelain:: |
44 | Show the porcelain format, but output commit information for | |
45 | each line, not just the first time a commit is referenced. | |
46 | Implies --porcelain. | |
47 | ||
635f4a30 AR |
48 | --incremental:: |
49 | Show the result incrementally in a format designed for | |
50 | machine consumption. | |
51 | ||
69cd8f63 AG |
52 | --encoding=<encoding>:: |
53 | Specifies the encoding used to output author names | |
54 | and commit summaries. Setting it to `none` makes blame | |
55 | output unconverted data. For more information see the | |
56 | discussion about encoding in the linkgit:git-log[1] | |
57 | manual page. | |
58 | ||
635f4a30 AR |
59 | --contents <file>:: |
60 | When <rev> is not specified, the command annotates the | |
61 | changes starting backwards from the working tree copy. | |
62 | This flag makes the command pretend as if the working | |
52727068 | 63 | tree copy has the contents of the named file (specify |
635f4a30 AR |
64 | `-` to make the command read from the standard input). |
65 | ||
31653c1a | 66 | --date <format>:: |
2df4e29c | 67 | Specifies the format used to output dates. If --date is not |
31653c1a EL |
68 | provided, the value of the blame.date config variable is |
69 | used. If the blame.date config variable is also not set, the | |
2df4e29c | 70 | iso format is used. For supported values, see the discussion |
31653c1a EL |
71 | of the --date option at linkgit:git-log[1]. |
72 | ||
aba37f49 ECA |
73 | --[no-]progress:: |
74 | Progress status is reported on the standard error stream | |
75 | by default when it is attached to a terminal. This flag | |
76 | enables progress reporting even if not attached to a | |
77 | terminal. Can't use `--progress` together with `--porcelain` | |
78 | or `--incremental`. | |
79 | ||
2b35a9f4 | 80 | -M[<num>]:: |
d8c416b2 JH |
81 | Detect moved or copied lines within a file. When a commit |
82 | moves or copies a block of lines (e.g. the original file | |
83 | has A and then B, and the commit changes it to B and then | |
84 | A), the traditional 'blame' algorithm notices only half of | |
85 | the movement and typically blames the lines that were moved | |
86 | up (i.e. B) to the parent and assigns blame to the lines that | |
87 | were moved down (i.e. A) to the child commit. With this | |
88 | option, both groups of lines are blamed on the parent by | |
89 | running extra passes of inspection. | |
3955d994 JH |
90 | + |
91 | <num> is optional but it is the lower bound on the number of | |
2de9b711 | 92 | alphanumeric characters that Git must detect as moving/copying |
3955d994 | 93 | within a file for it to associate those lines with the parent |
509de65f | 94 | commit. The default value is 20. |
635f4a30 | 95 | |
2b35a9f4 | 96 | -C[<num>]:: |
d8c416b2 | 97 | In addition to `-M`, detect lines moved or copied from other |
635f4a30 AR |
98 | files that were modified in the same commit. This is |
99 | useful when you reorganize your program and move code | |
100 | around across files. When this option is given twice, | |
88d50e78 RR |
101 | the command additionally looks for copies from other |
102 | files in the commit that creates the file. When this | |
103 | option is given three times, the command additionally | |
104 | looks for copies from other files in any commit. | |
3955d994 JH |
105 | + |
106 | <num> is optional but it is the lower bound on the number of | |
2de9b711 | 107 | alphanumeric characters that Git must detect as moving/copying |
3955d994 | 108 | between files for it to associate those lines with the parent |
509de65f BY |
109 | commit. And the default value is 40. If there are more than one |
110 | `-C` options given, the <num> argument of the last `-C` will | |
111 | take effect. | |
635f4a30 | 112 | |
3240240f | 113 | -h:: |
635f4a30 | 114 | Show help message. |