mirror of
https://github.com/git/git.git
synced 2024-11-25 19:04:18 +08:00
69cd8f6342
Currently git-blame outputs text from the commit messages (e.g. the author name and the summary string) as-is, without even providing any information about the encoding used for the data. It makes interpreting the data in multilingual environment very difficult. This commit changes the blame implementation to recode the messages using the rules used by other commands like git-log. Namely, the target encoding can be specified through the i18n.commitEncoding or i18n.logOutputEncoding options, or directly on the command line using the --encoding parameter. Converting the encoding before output seems to be more friendly to the porcelain tools than simply providing the value of the encoding header, and does not require changing the output format. If anybody needs the old behavior, it is possible to achieve it by specifying --encoding=none. Signed-off-by: Alexander Gavrilov <angavrilov@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
97 lines
2.8 KiB
Plaintext
97 lines
2.8 KiB
Plaintext
-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>::
|
|
Annotate only the given line range. <start> and <end> can take
|
|
one of these forms:
|
|
|
|
- number
|
|
+
|
|
If <start> or <end> is a number, it specifies an
|
|
absolute line number (lines count from 1).
|
|
+
|
|
|
|
- /regex/
|
|
+
|
|
This form will use the first line matching the given
|
|
POSIX regex. If <end> is a regex, it will search
|
|
starting at the line given by <start>.
|
|
+
|
|
|
|
- +offset or -offset
|
|
+
|
|
This is only valid for <end> and will specify a number
|
|
of lines before or after the line given by <start>.
|
|
+
|
|
|
|
-l::
|
|
Show long rev (Default: off).
|
|
|
|
-t::
|
|
Show raw timestamp (Default: off).
|
|
|
|
-S <revs-file>::
|
|
Use revs from revs-file instead of calling linkgit:git-rev-list[1].
|
|
|
|
-p::
|
|
--porcelain::
|
|
Show in a format designed for machine consumption.
|
|
|
|
--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>::
|
|
When <rev> is not specified, the command annotates the
|
|
changes starting backwards from the working tree copy.
|
|
This flag makes the command pretend as if the working
|
|
tree copy has the contents of the named file (specify
|
|
`-` to make the command read from the standard input).
|
|
|
|
-M|<num>|::
|
|
Detect moving lines in the file as well. When a commit
|
|
moves a block of lines in a file (e.g. the original file
|
|
has A and then B, and the commit changes it to B and
|
|
then A), traditional 'blame' algorithm 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.
|
|
+
|
|
<num> is optional but it is the lower bound on the number of
|
|
alphanumeric characters that git must detect as moving
|
|
within a file for it to associate those lines with the parent
|
|
commit.
|
|
|
|
-C|<num>|::
|
|
In addition to `-M`, detect lines 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 looks for copies from all other files in the
|
|
parent for the commit that creates the file in addition.
|
|
+
|
|
<num> is optional but it is the lower bound on the number of
|
|
alphanumeric characters that git must detect as moving
|
|
between files for it to associate those lines with the parent
|
|
commit.
|
|
|
|
-h::
|
|
--help::
|
|
Show help message.
|