aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/blame-options.txt
diff options
context:
space:
mode:
authorJacob Keller <jacob.keller@gmail.com>2023-04-24 12:35:08 -0700
committerJunio C Hamano <gitster@pobox.com>2023-04-24 15:16:31 -0700
commit603d0fdce2ca84d4dc7b26e46430778fe9c4cb72 (patch)
tree2e9694d9986637e357ad3191f21659cabee73077 /Documentation/blame-options.txt
parent7580f92ffa970b9484ac214f7b53cec5e26ca4bc (diff)
downloadgit-603d0fdce2ca84d4dc7b26e46430778fe9c4cb72.tar.gz
blame: use different author name for fake commit generated by --contents
When the --contents option is used with git blame, and the contents of the file have lines which can't be annotated by the history being blamed, the user will see an author of "Not Committed Yet". This is similar to the way blame handles working tree contents when blaming without a revision. This is slightly confusing since this data isn't the working copy and while it is technically "not committed yet", its also coming from an external file. Replace this author name with "External file (--contents)" to better differentiate such lines from actual working copy lines. Suggested-by: Junio C Hamano <gitster@pobox.com> Suggested-by: Glen Choo <chooglen@google.com> Signed-off-by: Jacob Keller <jacob.keller@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/blame-options.txt')
-rw-r--r--Documentation/blame-options.txt8
1 files changed, 3 insertions, 5 deletions
diff --git a/Documentation/blame-options.txt b/Documentation/blame-options.txt
index 95599bd6e5..552dcc60f2 100644
--- a/Documentation/blame-options.txt
+++ b/Documentation/blame-options.txt
@@ -64,11 +64,9 @@ include::line-range-format.txt[]
manual page.
--contents <file>::
- Pretend the file being annotated has a commit with the
- contents from the named file and a parent of <rev>,
- defaulting to HEAD when no <rev> is specified. You may
- specify '-' to make the command read from the standard
- input for the file contents.
+ 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