Re: [PATCHv2 6/6] rev-list/log: document logic with several limiting options
From: Junio C Hamano <hidden>
Date: 2016-06-15 22:54:44
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
Possibly related (same subject, not in this thread)
- 2016-06-15 · [PATCHv2 6/6] rev-list/log: document logic with several limiting options · Michael J Gruber <hidden>
- 2016-06-15 · Re: [PATCHv2 6/6] rev-list/log: document logic with several limiting options · Junio C Hamano <hidden>
- 2016-06-15 · Re: [PATCHv2 6/6] rev-list/log: document logic with several limiting options · Junio C Hamano <hidden>
Junio C Hamano [off-list ref] writes:
Assuming that the patch I posted earlier actually works, I think the description can become vastly simpler, if you stop explaining author and committer in terms of "grep".
And here is a replacement in a patch form. -- >8 -- Subject: [PATCH] log: document use of multiple commit limiting options Generally speaking, using more options will further narrow the selection, but there are a few exceptions. Document them. Signed-off-by: Junio C Hamano <redacted> --- Documentation/rev-list-options.txt | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-)
diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt
index 1ae3c89..57d6c90 100644
--- a/Documentation/rev-list-options.txt
+++ b/Documentation/rev-list-options.txt@@ -3,7 +3,14 @@ Commit Limiting Besides specifying a range of commits that should be listed using the special notations explained in the description, additional commit -limiting may be applied. Note that they are applied before commit +limiting may be applied. + +Using more options generally further limits the output (e.g. +"--since=<date1>" limits to commits newer than <date1>, and using it +with "--grep=<pattern>" further limits to commits whose log message +has a line that match <pattern>), unless otherwise noted. + +Note that these are applied before commit ordering and formatting options, such as '--reverse'. --
@@ -38,16 +45,22 @@ endif::git-rev-list[] --committer=<pattern>:: Limit the commits output to ones with author/committer - header lines that match the specified pattern (regular expression). + header lines that match the specified pattern (regular + expression). With more than one `--author=<pattern>`, + commits whose author match any of the given patterns are + chosen (similarly for multiple `--committer=<pattern>`). --grep=<pattern>:: Limit the commits output to ones with log message that - matches the specified pattern (regular expression). + matches the specified pattern (regular expression). With + more than one `--grep=<pattern>`, commits whose message + match any of the given patterns are chosen (but see + `--all-match`). --all-match:: Limit the commits output to ones that match all given --grep, - --author and --committer instead of ones that match at least one. + instead of ones that match at least one. -i:: --regexp-ignore-case::
--
1.7.12.469.g5235eb6