[PATCH v2 2/2] doc: log, gitk: line-log arguments must exist in starting revision
- From
Philippe Blain via GitGitGadget <gitgitgadget@gmail.com>
- Date
- Dec 26, 2019, 17:43 UTC
- Message-ID
- <c7d489794caa8f76e8d3cc4ec95b76279333dff1.1577382217.git.gitgitgadget@gmail.com>
- In-Reply-To
- <pull.494.v2.git.1577382217.gitgitgadget@gmail.com>
From: Philippe Blain <levraiphilippeblain@gmail.com>
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> --- Documentation/git-log.txt | 3 ++- Documentation/gitk.txt | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt index 6574c0d91f..bed09bb09e 100644 --- a/Documentation/git-log.txt +++ b/Documentation/git-log.txt @@ -76,7 +76,8 @@ produced by `--stat`, etc. (or the function name regex <funcname>) within the <file>. You may not give any pathspec limiters. This is currently limited to a walk starting from a single revision, i.e., you may only - give zero or one positive revision arguments. + give zero or one positive revision arguments, and + <start> and <end> (or <funcname>) must exist in the starting revision. You can specify this option more than once. Implies `--patch`. Patch output can be suppressed using `--no-patch`, but other diff formats (namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`, diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt index c487af5b74..c653ebb6a8 100644 --- a/Documentation/gitk.txt +++ b/Documentation/gitk.txt @@ -105,7 +105,8 @@ linkgit:git-rev-list[1] for a complete list. (or the function name regex <funcname>) within the <file>. You may not give any pathspec limiters. This is currently limited to a walk starting from a single revision, i.e., you may only - give zero or one positive revision arguments. + give zero or one positive revision arguments, and + <start> and <end> (or <funcname>) must exist in the starting revision. You can specify this option more than once. Implies `--patch`. Patch output can be suppressed using `--no-patch`, but other diff formats (namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,
-- gitgitgadget