diff options
author | Philippe Blain <levraiphilippeblain@gmail.com> | 2020-07-09 02:16:47 +0000 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2020-07-08 22:08:54 -0700 |
commit | 6be6b171a7dc4d901f21b0f24d63147c32ecc008 (patch) | |
tree | 2c8828ce6e37b438791c031fd017647793dacb0b /Documentation/git-rev-list.txt | |
parent | 6001a1d5e3732cb63438ce2c7852773d3c0eab9a (diff) | |
download | git-6be6b171a7dc4d901f21b0f24d63147c32ecc008.tar.gz |
git-rev-list.txt: move description to separate file
A following commit will reuse the description of the `git rev-list`
command in the `git log` manpage.
Move this description to a separate file.
Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-rev-list.txt')
-rw-r--r-- | Documentation/git-rev-list.txt | 39 |
1 files changed, 1 insertions, 38 deletions
diff --git a/Documentation/git-rev-list.txt b/Documentation/git-rev-list.txt index f2b83df2fa..b06e11ae56 100644 --- a/Documentation/git-rev-list.txt +++ b/Documentation/git-rev-list.txt @@ -14,44 +14,7 @@ SYNOPSIS DESCRIPTION ----------- -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. - -You can think of this as a set operation. Commits reachable from any of -the commits given on the command line form a set, 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 reachable from 'foo' or 'bar', but -not from 'baz'". - -A special notation "'<commit1>'..'<commit2>'" can be used as a -short-hand for "^'<commit1>' '<commit2>'". For example, either of -the following may be used interchangeably: - ------------------------------------------------------------------------ -$ git rev-list origin..HEAD -$ git rev-list HEAD ^origin ------------------------------------------------------------------------ - -Another special notation is "'<commit1>'...'<commit2>'" which is useful -for merges. The resulting set of commits is the symmetric difference -between the two operands. The following two commands are equivalent: - ------------------------------------------------------------------------ -$ git rev-list A B --not $(git merge-base --all A B) -$ git rev-list A...B ------------------------------------------------------------------------ +include::rev-list-description.txt[] 'rev-list' is a very essential Git command, since it provides the ability to build and traverse commit ancestry graphs. For |