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 <gitster@pobox.com>
Junio C Hamano committed
Sep 13, 2012 at 18:54 UTC
a23e3138cb4ddd57e9cbb221e8cbfaf233111d2c
1 file changed
+18
-5
Documentation/rev-list-options.txt
+18
-5
@@ -3,8 +3,15 @@ Commit Limiting
3
4
Besides specifying a range of commits that should be listed using the
5
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`.
15
16
--
17
@@ -38,16 +45,22 @@ endif::git-rev-list[]
45
--committer=<pattern>::
46
47
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>`).
52
53
--grep=<pattern>::
54
55
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`).
60
61
--all-match::
62
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.
64
65
-i::
66
--regexp-ignore-case::