diff options
author | Junio C Hamano <junio@hera.kernel.org> | 2009-08-07 05:40:01 +0000 |
---|---|---|
committer | Junio C Hamano <junio@hera.kernel.org> | 2009-08-07 05:40:01 +0000 |
commit | 31cca1669fe45cbdca5a7f6b888e9a1d04ee1f10 (patch) | |
tree | 152d8b7c4fef605a85d8580e3ca08c91dcffe584 /git-rev-list.txt | |
parent | fd9274d4a1afb62d888e84717c5f0e67850fc96a (diff) | |
download | git-htmldocs-31cca1669fe45cbdca5a7f6b888e9a1d04ee1f10.tar.gz |
Autogenerated HTML docs for v1.6.4-59-g4d590
Diffstat (limited to 'git-rev-list.txt')
-rw-r--r-- | git-rev-list.txt | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/git-rev-list.txt b/git-rev-list.txt index a765cfa4d..bf98c8449 100644 --- a/git-rev-list.txt +++ b/git-rev-list.txt @@ -51,20 +51,26 @@ SYNOPSIS DESCRIPTION ----------- -Lists commit objects in reverse chronological order starting at the -given commit(s), taking ancestry relationship into account. This is -useful to produce human-readable log output. +List commits that are reachable by following the `parent` links from the +given commit(s), but exclude commits that are reachable from the one(s) +given with a '{caret}' in front of them. The output is given in reverse +chronological order by default. -Commits which are stated with a preceding '{caret}' cause listing to -stop at that point. Their parents are implied. Thus the following -command: +You can think of this as a set operation. Commits given on the command +line form a set of commits that are reachable from any of them, and then +commits reachable from any of the ones given with '{caret}' in front are +subtracted from that set. The remaining commits are what comes out in the +command's output. Various other options and paths parameters can be used +to further limit the result. + +Thus, the following command: ----------------------------------------------------------------------- $ git rev-list foo bar ^baz ----------------------------------------------------------------------- -means "list all the commits which are included in 'foo' and 'bar', but -not in 'baz'". +means "list all the commits which are reachable from 'foo' or 'bar', but +not from 'baz'". A special notation "'<commit1>'..'<commit2>'" can be used as a short-hand for "{caret}'<commit1>' '<commit2>'". For example, either of |