[PATCH] Change the sed seperator in t/t6000-lib.sh.
[alt-git.git] / Documentation / git-rev-tree.txt
blob2ec7ed073bf0795016d2b0134c68c438cdc9c13e
1 git-rev-tree(1)
2 ===============
3 v0.1, May 2005
5 NAME
6 ----
7 git-rev-tree - Provides the revision tree for one or more commits
10 SYNOPSIS
11 --------
12 'git-rev-tree' [--edges] [--cache <cache-file>] [^]<commit> [[^]<commit>]
14 DESCRIPTION
15 -----------
16 Provides the revision tree for one or more commits.
18 OPTIONS
19 -------
20 --edges::
21         Show edges (ie places where the marking changes between parent
22         and child)
24 --cache <cache-file>::
25         Use the specified file as a cache from a previous git-rev-list run
26         to speed things up.  Note that this "cache" is totally different
27         concept from the directory index.  Also this option is not
28         implemented yet.
30 [^]<commit>::
31         The commit id to trace (a leading caret means to ignore this
32         commit-id and below)
34 Output
35 ------
37         <date> <commit>:<flags> [<parent-commit>:<flags> ]\*
39 <date>::
40         Date in 'seconds since epoch'
42 <commit>::
43         id of commit object
45 <parent-commit>::
46         id of each parent commit object (>1 indicates a merge)
48 <flags>::
50         The flags are read as a bitmask representing each commit
51         provided on the commandline. eg: given the command:
53                  $ git-rev-tree <com1> <com2> <com3>
55         The output:
57             <date> <commit>:5
59          means that <commit> is reachable from <com1>(1) and <com3>(4)
60         
61 A revtree can get quite large. "git-rev-tree" will eventually allow
62 you to cache previous state so that you don't have to follow the whole
63 thing down.
65 So the change difference between two commits is literally
67         git-rev-tree [commit-id1]  > commit1-revtree
68         git-rev-tree [commit-id2]  > commit2-revtree
69         join -t : commit1-revtree commit2-revtree > common-revisions
71 (this is also how to find the most common parent - you'd look at just
72 the head revisions - the ones that aren't referred to by other
73 revisions - in "common-revision", and figure out the best one. I
74 think.)
77 Author
78 ------
79 Written by Linus Torvalds <torvalds@osdl.org>
81 Documentation
82 --------------
83 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
85 GIT
86 ---
87 Part of the link:git.html[git] suite