]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/blame-options.txt
Merge branch 'js/t3404-typofix' into maint
[thirdparty/git.git] / Documentation / blame-options.txt
CommitLineData
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 20include::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 92alphanumeric characters that Git must detect as moving/copying
3955d994 93within a file for it to associate those lines with the parent
509de65f 94commit. 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 107alphanumeric characters that Git must detect as moving/copying
3955d994 108between files for it to associate those lines with the parent
509de65f
BY
109commit. And the default value is 40. If there are more than one
110`-C` options given, the <num> argument of the last `-C` will
111take effect.
635f4a30 112
3240240f 113-h::
635f4a30 114 Show help message.