[PATCH 2/2] Documentation/git-log: mention that line-log regex must match in starting revision

From: Philippe Blain via GitGitGadget <gitgitgadget@gmail.com>
Date: Dec 17, 2019, 05:07 UTC
Message-ID: <4ea4eeae0c1e23221012855168bf6640be93fd4f.1576559263.git.gitgitgadget@gmail.com>
In-Reply-To: <pull.494.git.1576559263.gitgitgadget@gmail.com>

From: Philippe Blain <levraiphilippeblain@gmail.com>

When giving a regex as parameter <start> or <end> in `git log -L <start>,<end>:<file>`, or a function name in `git log -L :<funcname>:<file>`, the given regex must match 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 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt
index 1c52bf184d..5c3fd39048 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 any given regex for
+	<start> or <end> (or <funcname>) must match in the starting revision.
 	You can specify this option more than once. Implies `--patch`.
 	If ``:<funcname>'' is given, implies `--function-context`.
 	Patch output can be suppressed using `-s`, but other diff formats

-- 
gitgitgadget