This example was overly complex and therefore confusing.
The commits have been renamed to start the oldest commit with "A"
and working up from there. Also, this removes some commits so the graph
is simpler. Finally the graph has been reversed in direction to make it
more like gitk.
Signed-off-by: Pieter de Bie <pdebie@xxxxxxxxx>
---
This was created after some discussion in #git about how this was confusing.
The consesus was that this example is better.
Documentation/git-rev-parse.txt | 69 ++++++++++++++++++++-------------------
1 files changed, 35 insertions(+), 34 deletions(-)
diff --git a/Documentation/git-rev-parse.txt b/Documentation/git-rev-parse.txt
index 9e273bc..ddeb496 100644
--- a/Documentation/git-rev-parse.txt
+++ b/Documentation/git-rev-parse.txt
@@ -243,34 +243,34 @@ blobs contained in a commit.
(typically the current branch), and stage 3 is the version from
the branch being merged.
-Here is an illustration, by Jon Loeliger. Both commit nodes B
-and C are parents of commit node A. Parent commits are ordered
-left-to-right.
+Here is an illustration. The newest commits are on the top.
+Commit H is a merge commit: its parents are both commit nodes F and G.
+Parent commits are ordered left-to-right.
........................................
-G H I J
- \ / \ /
- D E F
- \ | / \
- \ | / |
- \|/ |
- B C
- \ /
- \ /
- A
-........................................
- A = = A^0
- B = A^ = A^1 = A~1
- C = A^2 = A^2
- D = A^^ = A^1^1 = A~2
- E = B^2 = A^^2
- F = B^3 = A^^3
- G = A^^^ = A^1^1^1 = A~3
- H = D^2 = B^^2 = A^^^2 = A~2^2
- I = F^ = B^3^ = A^^3^
- J = F^2 = B^3^2 = A^^3^2
+ H
+ / \
+ / \
+ F G
+ / \ |
+ / \ |
+ / \ /
+ D E
+ / \ |
+A B C
+
+........................................
+ H = H^0
+ F = H^ = H^1 = H~1
+ G = H^2
+ D = H^^ = H^1^1 = H~2
+ E = F^2 = H^^2
+ E = F^3 = H^^3 = H^2^
+ A = H^^^ = H^1^1^1 = H~3
+ B = D^ = H^^^2 = H~2^2
+ C = E^ = H^^3^
SPECIFYING RANGES
-----------------
@@ -302,16 +302,17 @@ and its parent commits exists. `r1{caret}@` notation means all
parents of `r1`. `r1{caret}!` includes commit `r1` but excludes
its all parents.
-Here are a handful of examples:
-
- D G H D
- D F G H I J D F
- ^G D H D
- ^D B E I J F B
- B...C G H D E B C
- ^D B C E I J F B C
- C^@ I J F
- F^! D G H D F
+Here are a handful of examples. Note that there is no ordering in
+the set of commits. See also linkgit:git-rev-list[1]'s --topo-order
+and --date-order.
+
+ D A B D
+ D E A B C D E
+ ^A D B D
+ ^D F C E F
+ F...G A B D F G
+ D^@ A B
+ E^! D A B D E
PARSEOPT
--------
--
1.5.6.rc1.153.gc1d96
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
