Skip to content

Commit ace0f86

Browse files
phil-blaingitster
authored andcommitted
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 <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 2be4586 commit ace0f86

File tree

2 files changed

+4
-2
lines changed

2 files changed

+4
-2
lines changed

Documentation/git-log.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,8 @@ produced by `--stat`, etc.
7676
(or the function name regex <funcname>) within the <file>. You may
7777
not give any pathspec limiters. This is currently limited to
7878
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.
8081
You can specify this option more than once. Implies `--patch`.
8182
Patch output can be suppressed using `--no-patch`, but other diff formats
8283
(namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,

Documentation/gitk.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,8 @@ linkgit:git-rev-list[1] for a complete list.
105105
(or the function name regex <funcname>) within the <file>. You may
106106
not give any pathspec limiters. This is currently limited to
107107
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.
109110
You can specify this option more than once. Implies `--patch`.
110111
Patch output can be suppressed using `--no-patch`, but other diff formats
111112
(namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,

0 commit comments

Comments
 (0)