git-commit-vandalism/Documentation/config
Barret Rhoden 8934ac8c92 blame: add config options for the output of ignored or unblamable lines
When ignoring commits, the commit that is blamed might not be
responsible for the change, due to the inaccuracy of our heuristic.
Users might want to know when a particular line has a potentially
inaccurate blame.

Furthermore, guess_line_blames() may fail to find any parent commit for
a given line touched by an ignored commit.  Those 'unblamable' lines
remain blamed on an ignored commit.  Users might want to know if a line
is unblamable so that they do not spend time investigating a commit they
know is uninteresting.

This patch adds two config options to mark these two types of lines in
the output of blame.

The first option can identify ignored lines by specifying
blame.markIgnoredLines.  When this option is set, each blame line that
was blamed on a commit other than the ignored commit is marked with a
'?'.

For example:
	278b6158d6fdb (Barret Rhoden  2016-04-11 13:57:54 -0400 26)
appears as:
	?278b6158d6fd (Barret Rhoden  2016-04-11 13:57:54 -0400 26)

where the '?' is placed before the commit, and the hash has one fewer
characters.

Sometimes we are unable to even guess at what ancestor commit touched a
line.  These lines are 'unblamable.'  The second option,
blame.markUnblamableLines, will mark the line with '*'.

For example, say we ignore e5e8d36d04cbe, yet we are unable to blame
this line on another commit:
	e5e8d36d04cbe (Barret Rhoden  2016-04-11 13:57:54 -0400 26)
appears as:
	*e5e8d36d04cb (Barret Rhoden  2016-04-11 13:57:54 -0400 26)

When these config options are used together, every line touched by an
ignored commit will be marked with either a '?' or a '*'.

Signed-off-by: Barret Rhoden <brho@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2019-05-16 11:36:23 +09:00
..
add.txt
advice.txt push: add an advice on unqualified <dst> push 2018-11-14 15:27:55 +09:00
alias.txt
am.txt
apply.txt
blame.txt blame: add config options for the output of ignored or unblamable lines 2019-05-16 11:36:23 +09:00
branch.txt
browser.txt
checkout.txt
clean.txt
color.txt
column.txt
commit.txt
completion.txt
core.txt Merge branch 'js/mingw-perl5lib' 2018-11-13 22:37:20 +09:00
credential.txt
diff.txt Merge branch 'nd/config-split' 2018-11-13 22:37:16 +09:00
difftool.txt
fastimport.txt
fetch.txt
filter.txt
fmt-merge-msg.txt
format.txt
fsck.txt
gc.txt
gitcvs.txt
gitweb.txt
gpg.txt
grep.txt
gui.txt
guitool.txt
help.txt
http.txt Merge branch 'fc/http-version' 2019-01-04 13:33:32 -08:00
i18n.txt
imap.txt
index.txt index: make index.threads=true enable ieot and eoie 2018-11-21 16:46:54 +09:00
init.txt
instaweb.txt
interactive.txt
log.txt
mailinfo.txt
mailmap.txt
man.txt
merge.txt Merge branch 'nd/config-split' 2018-11-13 22:37:16 +09:00
mergetool.txt
notes.txt
pack.txt
pager.txt
pretty.txt
protocol.txt
pull.txt config.txt: move pull-config.txt to config/ 2018-10-29 10:17:03 +09:00
push.txt config.txt: move push-config.txt to config/ 2018-10-29 10:17:03 +09:00
rebase.txt rebase doc: document rebase.useBuiltin 2018-11-16 19:02:54 +09:00
receive.txt config.txt: move receive-config.txt to config/ 2018-10-29 10:17:03 +09:00
remote.txt config.txt: move remote.* to a separate file 2018-10-29 10:17:03 +09:00
remotes.txt config.txt: move remotes.* to a separate file 2018-10-29 10:17:03 +09:00
repack.txt config.txt: move repack.* to a separate file 2018-10-29 10:17:04 +09:00
rerere.txt config.txt: move rerere.* to a separate file 2018-10-29 10:17:04 +09:00
reset.txt config.txt: move reset.* to a separate file 2018-10-29 10:17:04 +09:00
sendemail.txt config.txt: move sendemail-config.txt to config/ 2018-10-29 10:17:04 +09:00
sequencer.txt config.txt: move sequencer.* to a separate file 2018-10-29 10:17:04 +09:00
showbranch.txt config.txt: move showBranch.* to a separate file 2018-10-29 10:17:04 +09:00
splitindex.txt config.txt: move splitIndex.* to a separate file 2018-10-29 10:17:04 +09:00
ssh.txt
stash.txt config.txt: move stash.* to a separate file 2018-10-29 10:17:04 +09:00
status.txt config.txt: move status.* to a separate file 2018-10-29 10:17:04 +09:00
submodule.txt config.txt: move submodule.* to a separate file 2018-10-29 10:17:04 +09:00
tag.txt config.txt: move tag.* to a separate file 2018-10-29 10:17:04 +09:00
transfer.txt config.txt: move transfer.* to a separate file 2018-10-29 10:17:04 +09:00
uploadarchive.txt config.txt: move uploadarchive.* to a separate file 2018-10-29 10:17:04 +09:00
uploadpack.txt config.txt: move uploadpack.* to a separate file 2018-10-29 10:17:04 +09:00
url.txt config.txt: move url.* to a separate file 2018-10-29 10:17:04 +09:00
user.txt config.txt: move user.* to a separate file 2018-10-29 10:17:05 +09:00
versionsort.txt config.txt: move versionsort.* to a separate file 2018-10-29 10:17:05 +09:00
web.txt config.txt: move web.* to a separate file 2018-10-29 10:17:05 +09:00
worktree.txt config.txt: move worktree.* to a separate file 2018-10-29 10:17:05 +09:00