42357b4e8b
Allow easier parsing by cat-file by giving rev-list an option to print
only the OID of a non-commit object without any additional information.
This is a short-term shim; later on, rev-list should be taught how to
print the types of objects it finds in a format similar to cat-file's.
Before this commit, the output from rev-list needed to be massaged
before being piped to cat-file, like so:
git rev-list --objects HEAD | cut -f 1 -d ' ' |
git cat-file --batch-check
This was especially unexpected when dealing with root trees, as an
invisible whitespace exists at the end of the OID:
git rev-list --objects --filter=tree:1 --max-count=1 HEAD |
xargs -I% echo "AA%AA"
Now, it can be piped directly, as in the added test case:
git rev-list --objects --no-object-names HEAD | git cat-file --batch-check
Signed-off-by: Emily Shaffer <emilyshaffer@google.com>
Change-Id: I489bdf0a8215532e540175188883ff7541d70e1b
Signed-off-by: Junio C Hamano <gitster@pobox.com>
125 lines
3.7 KiB
Plaintext
125 lines
3.7 KiB
Plaintext
git-rev-list(1)
|
|
===============
|
|
|
|
NAME
|
|
----
|
|
git-rev-list - Lists commit objects in reverse chronological order
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git rev-list' [ --max-count=<number> ]
|
|
[ --skip=<number> ]
|
|
[ --max-age=<timestamp> ]
|
|
[ --min-age=<timestamp> ]
|
|
[ --sparse ]
|
|
[ --merges ]
|
|
[ --no-merges ]
|
|
[ --min-parents=<number> ]
|
|
[ --no-min-parents ]
|
|
[ --max-parents=<number> ]
|
|
[ --no-max-parents ]
|
|
[ --first-parent ]
|
|
[ --remove-empty ]
|
|
[ --full-history ]
|
|
[ --not ]
|
|
[ --all ]
|
|
[ --branches[=<pattern>] ]
|
|
[ --tags[=<pattern>] ]
|
|
[ --remotes[=<pattern>] ]
|
|
[ --glob=<glob-pattern> ]
|
|
[ --ignore-missing ]
|
|
[ --stdin ]
|
|
[ --quiet ]
|
|
[ --topo-order ]
|
|
[ --parents ]
|
|
[ --timestamp ]
|
|
[ --left-right ]
|
|
[ --left-only ]
|
|
[ --right-only ]
|
|
[ --cherry-mark ]
|
|
[ --cherry-pick ]
|
|
[ --encoding=<encoding> ]
|
|
[ --(author|committer|grep)=<pattern> ]
|
|
[ --regexp-ignore-case | -i ]
|
|
[ --extended-regexp | -E ]
|
|
[ --fixed-strings | -F ]
|
|
[ --date=<format>]
|
|
[ [ --objects | --objects-edge | --objects-edge-aggressive ]
|
|
[ --unpacked ]
|
|
[ --object-names | --no-object-names ]
|
|
[ --filter=<filter-spec> [ --filter-print-omitted ] ] ]
|
|
[ --missing=<missing-action> ]
|
|
[ --pretty | --header ]
|
|
[ --bisect ]
|
|
[ --bisect-vars ]
|
|
[ --bisect-all ]
|
|
[ --merge ]
|
|
[ --reverse ]
|
|
[ --walk-reflogs ]
|
|
[ --no-walk ] [ --do-walk ]
|
|
[ --count ]
|
|
[ --use-bitmap-index ]
|
|
<commit>... [ \-- <paths>... ]
|
|
|
|
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 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 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
|
|
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
|
|
-----------------------------------------------------------------------
|
|
|
|
'rev-list' is a very essential Git command, since it
|
|
provides the ability to build and traverse commit ancestry graphs. For
|
|
this reason, it has a lot of different options that enables it to be
|
|
used by commands as different as 'git bisect' and
|
|
'git repack'.
|
|
|
|
OPTIONS
|
|
-------
|
|
|
|
:git-rev-list: 1
|
|
include::rev-list-options.txt[]
|
|
|
|
include::pretty-formats.txt[]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|