undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

log: document use of multiple commit limiting options

Browse Source 
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>
This commit is contained in:
Junio C Hamano 2012-09-13 18:54:30 -07:00
parent 13e4fc7e01
commit a23e3138cb
1 changed files with 18 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Documentation/rev-list-options.txt
View File

@ -3,8 +3,15 @@ Commit Limiting
Besides specifying a range of commits that should be listed using the Besides specifying a range of commits that should be listed using the
special notations explained in the description, additional commit special notations explained in the description, additional commit
limiting may be applied. Note that they are applied before commit limiting may be applied.
ordering and formatting options, such as '--reverse'.
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 matches `<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>:: --committer=<pattern>::
Limit the commits output to ones with author/committer 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 matches any of the given patterns are
chosen (similarly for multiple `--committer=<pattern>`).
--grep=<pattern>:: --grep=<pattern>::
Limit the commits output to ones with log message that 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
matches any of the given patterns are chosen (but see
`--all-match`).
--all-match:: --all-match::
Limit the commits output to ones that match all given --grep, 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:: -i::
--regexp-ignore-case:: --regexp-ignore-case::