doc: log, gitk: line-log arguments must exist in starting revision
The line number, regex or offset parameters <start> and <end> in `git log -L <start>,<end>:<file>`, or the function name regex in `git log -L :<funcname>:<file>` must exist in the starting revision, or else the command exits with a fatal error. This is not obvious in the documentation, so add a note to that effect. Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Philippe Blain committed
Dec 26, 2019 at 17:43 UTC
ace0f86c7f527d3e7d0e9fc98ea94675387d2934
2 files changed
+4
-2
Documentation/git-log.txt
+2
-1
@@ -76,7 +76,8 @@ produced by `--stat`, etc.
76
(or the function name regex <funcname>) within the <file>. You may
77
not give any pathspec limiters. This is currently limited to
78
a walk starting from a single revision, i.e., you may only
79
- give zero or one positive revision arguments.
79
+ give zero or one positive revision arguments, and
80
+ <start> and <end> (or <funcname>) must exist in the starting revision.
81
You can specify this option more than once. Implies `--patch`.
82
Patch output can be suppressed using `--no-patch`, but other diff formats
83
(namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,
Documentation/gitk.txt
+2
-1
@@ -105,7 +105,8 @@ linkgit:git-rev-list[1] for a complete list.
105
(or the function name regex <funcname>) within the <file>. You may
106
not give any pathspec limiters. This is currently limited to
107
a walk starting from a single revision, i.e., you may only
108
- give zero or one positive revision arguments.
108
+ give zero or one positive revision arguments, and
109
+ <start> and <end> (or <funcname>) must exist in the starting revision.
110
You can specify this option more than once. Implies `--patch`.
111
Patch output can be suppressed using `--no-patch`, but other diff formats
112
(namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,