8
SYNOPSIS
9
--------
10
[verse]
11
-'git-blame' [-c] [-l] [-t] [-f] [-n] [-p] [--incremental] [-L n,m] [-S <revs-file>]
12
- [-M] [-C] [-C] [--since=<date>] [<rev> | --contents <file>] [--] <file>
11
+'git-blame' [-c] [-l] [-t] [-f] [-n] [-p] [--incremental] [-L n,m]
12
+ [-S <revs-file>] [-M] [-C] [-C] [--since=<date>]
13
+ [<rev> | --contents <file>] [--] <file>
14
15
DESCRIPTION
16
-----------
38
39
OPTIONS
40
-------
40
--c, --compatibility::
41
- Use the same output mode as gitlink:git-annotate[1] (Default: off).
42
-
43
--L n,m::
44
- Annotate only the specified line range (lines count from 1).
45
-
46
--l, --long::
47
- Show long rev (Default: off).
41
+include::blame-options.txt[]
42
49
--t, --time::
50
- Show raw timestamp (Default: off).
43
+-c::
44
+ Use the same output mode as gitlink:git-annotate[1] (Default: off).
45
52
--S, --rev-file <revs-file>::
53
- Use revs from revs-file instead of calling gitlink:git-rev-list[1].
46
+--score-debug::
47
+ Include debugging information related to the movement of
48
+ lines between files (see `-C`) and lines moved within a
49
+ file (see `-M`). The first number listed is the score.
50
+ This is the number of alphanumeric characters detected
51
+ to be moved between or within files. This must be above
52
+ a certain threshold for git-blame to consider those lines
53
+ of code to have been moved.
54
55
-f, --show-name::
56
Show filename in the original commit. By default
60
-n, --show-number::
61
Show line number in the original commit (Default: off).
62
63
--p, --porcelain::
64
- Show in a format designed for machine consumption.
65
-
66
---incremental::
67
- Show the result incrementally in a format designed for
68
- machine consumption.
69
-
70
---contents <file>::
71
- When <rev> is not specified, the command annotates the
72
- changes starting backwards from the working tree copy.
73
- This flag makes the command pretend as if the working
74
- tree copy has the contents of he named file (specify
75
- `-` to make the command read from the standard input).
76
-
77
--M::
78
- Detect moving lines in the file as well. When a commit
79
- moves a block of lines in a file (e.g. the original file
80
- has A and then B, and the commit changes it to B and
81
- then A), traditional 'blame' algorithm typically blames
82
- the lines that were moved up (i.e. B) to the parent and
83
- assigns blame to the lines that were moved down (i.e. A)
84
- to the child commit. With this option, both groups of
85
- lines are blamed on the parent.
86
-
87
--C::
88
- In addition to `-M`, detect lines copied from other
89
- files that were modified in the same commit. This is
90
- useful when you reorganize your program and move code
91
- around across files. When this option is given twice,
92
- the command looks for copies from all other files in the
93
- parent for the commit that creates the file in addition.
94
-
95
--h, --help::
96
- Show help message.
97
-
98
-
63
THE PORCELAIN FORMAT
64
--------------------
65