Skip to content

Commit a23e313

Browse files
committed
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 <[email protected]>
1 parent 13e4fc7 commit a23e313

File tree

1 file changed

+18
-5
lines changed

1 file changed

+18
-5
lines changed

Documentation/rev-list-options.txt

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,15 @@ Commit Limiting
33

44
Besides specifying a range of commits that should be listed using the
55
special notations explained in the description, additional commit
6-
limiting may be applied. Note that they are applied before commit
7-
ordering and formatting options, such as '--reverse'.
6+
limiting may be applied.
7+
8+
Using more options generally further limits the output (e.g.
9+
`--since=<date1>` limits to commits newer than `<date1>`, and using it
10+
with `--grep=<pattern>` further limits to commits whose log message
11+
has a line that matches `<pattern>`), unless otherwise noted.
12+
13+
Note that these are applied before commit
14+
ordering and formatting options, such as `--reverse`.
815

916
--
1017

@@ -38,16 +45,22 @@ endif::git-rev-list[]
3845
--committer=<pattern>::
3946

4047
Limit the commits output to ones with author/committer
41-
header lines that match the specified pattern (regular expression).
48+
header lines that match the specified pattern (regular
49+
expression). With more than one `--author=<pattern>`,
50+
commits whose author matches any of the given patterns are
51+
chosen (similarly for multiple `--committer=<pattern>`).
4252

4353
--grep=<pattern>::
4454

4555
Limit the commits output to ones with log message that
46-
matches the specified pattern (regular expression).
56+
matches the specified pattern (regular expression). With
57+
more than one `--grep=<pattern>`, commits whose message
58+
matches any of the given patterns are chosen (but see
59+
`--all-match`).
4760

4861
--all-match::
4962
Limit the commits output to ones that match all given --grep,
50-
--author and --committer instead of ones that match at least one.
63+
instead of ones that match at least one.
5164

5265
-i::
5366
--regexp-ignore-case::

0 commit comments

Comments
 (0)