You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
149 lines
5.9 KiB
149 lines
5.9 KiB
-b:: |
|
Show blank SHA-1 for boundary commits. This can also |
|
be controlled via the `blame.blankBoundary` config option. |
|
|
|
--root:: |
|
Do not treat root commits as boundaries. This can also be |
|
controlled via the `blame.showRoot` config option. |
|
|
|
--show-stats:: |
|
Include additional statistics at the end of blame output. |
|
|
|
-L <start>,<end>:: |
|
-L :<funcname>:: |
|
Annotate only the line range given by '<start>,<end>', |
|
or by the function name regex '<funcname>'. |
|
May be specified multiple times. Overlapping ranges are allowed. |
|
+ |
|
'<start>' and '<end>' are optional. `-L <start>` or `-L <start>,` spans from |
|
'<start>' to end of file. `-L ,<end>` spans from start of file to '<end>'. |
|
+ |
|
include::line-range-format.txt[] |
|
|
|
-l:: |
|
Show long rev (Default: off). |
|
|
|
-t:: |
|
Show raw timestamp (Default: off). |
|
|
|
-S <revs-file>:: |
|
Use revisions from revs-file instead of calling linkgit:git-rev-list[1]. |
|
|
|
--reverse <rev>..<rev>:: |
|
Walk history forward instead of backward. Instead of showing |
|
the revision in which a line appeared, this shows the last |
|
revision in which a line has existed. This requires a range of |
|
revision like START..END where the path to blame exists in |
|
START. `git blame --reverse START` is taken as `git blame |
|
--reverse START..HEAD` for convenience. |
|
|
|
--first-parent:: |
|
Follow only the first parent commit upon seeing a merge |
|
commit. This option can be used to determine when a line |
|
was introduced to a particular integration branch, rather |
|
than when it was introduced to the history overall. |
|
|
|
-p:: |
|
--porcelain:: |
|
Show in a format designed for machine consumption. |
|
|
|
--line-porcelain:: |
|
Show the porcelain format, but output commit information for |
|
each line, not just the first time a commit is referenced. |
|
Implies --porcelain. |
|
|
|
--incremental:: |
|
Show the result incrementally in a format designed for |
|
machine consumption. |
|
|
|
--encoding=<encoding>:: |
|
Specifies the encoding used to output author names |
|
and commit summaries. Setting it to `none` makes blame |
|
output unconverted data. For more information see the |
|
discussion about encoding in the linkgit:git-log[1] |
|
manual page. |
|
|
|
--contents <file>:: |
|
Annotate using the contents from the named file, starting from <rev> |
|
if it is specified, and HEAD otherwise. You may specify '-' to make |
|
the command read from the standard input for the file contents. |
|
|
|
--date <format>:: |
|
Specifies the format used to output dates. If --date is not |
|
provided, the value of the blame.date config variable is |
|
used. If the blame.date config variable is also not set, the |
|
iso format is used. For supported values, see the discussion |
|
of the --date option at linkgit:git-log[1]. |
|
|
|
--[no-]progress:: |
|
Progress status is reported on the standard error stream |
|
by default when it is attached to a terminal. This flag |
|
enables progress reporting even if not attached to a |
|
terminal. Can't use `--progress` together with `--porcelain` |
|
or `--incremental`. |
|
|
|
-M[<num>]:: |
|
Detect moved or copied lines within a file. When a commit |
|
moves or copies a block of lines (e.g. the original file |
|
has A and then B, and the commit changes it to B and then |
|
A), the traditional 'blame' algorithm notices only half of |
|
the movement and typically blames the lines that were moved |
|
up (i.e. B) to the parent and assigns blame to the lines that |
|
were moved down (i.e. A) to the child commit. With this |
|
option, both groups of lines are blamed on the parent by |
|
running extra passes of inspection. |
|
+ |
|
<num> is optional but it is the lower bound on the number of |
|
alphanumeric characters that Git must detect as moving/copying |
|
within a file for it to associate those lines with the parent |
|
commit. The default value is 20. |
|
|
|
-C[<num>]:: |
|
In addition to `-M`, detect lines moved or copied from other |
|
files that were modified in the same commit. This is |
|
useful when you reorganize your program and move code |
|
around across files. When this option is given twice, |
|
the command additionally looks for copies from other |
|
files in the commit that creates the file. When this |
|
option is given three times, the command additionally |
|
looks for copies from other files in any commit. |
|
+ |
|
<num> is optional but it is the lower bound on the number of |
|
alphanumeric characters that Git must detect as moving/copying |
|
between files for it to associate those lines with the parent |
|
commit. And the default value is 40. If there are more than one |
|
`-C` options given, the <num> argument of the last `-C` will |
|
take effect. |
|
|
|
--ignore-rev <rev>:: |
|
Ignore changes made by the revision when assigning blame, as if the |
|
change never happened. Lines that were changed or added by an ignored |
|
commit will be blamed on the previous commit that changed that line or |
|
nearby lines. This option may be specified multiple times to ignore |
|
more than one revision. If the `blame.markIgnoredLines` config option |
|
is set, then lines that were changed by an ignored commit and attributed to |
|
another commit will be marked with a `?` in the blame output. If the |
|
`blame.markUnblamableLines` config option is set, then those lines touched |
|
by an ignored commit that we could not attribute to another revision are |
|
marked with a '*'. |
|
|
|
--ignore-revs-file <file>:: |
|
Ignore revisions listed in `file`, which must be in the same format as an |
|
`fsck.skipList`. This option may be repeated, and these files will be |
|
processed after any files specified with the `blame.ignoreRevsFile` config |
|
option. An empty file name, `""`, will clear the list of revs from |
|
previously processed files. |
|
|
|
--color-lines:: |
|
Color line annotations in the default format differently if they come from |
|
the same commit as the preceding line. This makes it easier to distinguish |
|
code blocks introduced by different commits. The color defaults to cyan and |
|
can be adjusted using the `color.blame.repeatedLines` config option. |
|
|
|
--color-by-age:: |
|
Color line annotations depending on the age of the line in the default format. |
|
The `color.blame.highlightRecent` config option controls what color is used for |
|
each range of age. |
|
|
|
-h:: |
|
Show help message.
|
|
|