[RFD] How to better document the "two and three dots" format
- From
- Paolo Ciarrocchi <paolo.ciarrocchi@gmail.com>
- Date
- Sep 1, 2008, 12:43 UTC
- Message-ID
- <4d8e3fd30809010543o1e1562c1s4466e191e782ddcc@mail.gmail.com>
Hi all, I'm looking in the existing documentation about some example and clarification about the two and three dots formats applied to git diff.
The git-diff.txt file includes the following:
---8<--- Comparing branches:: + ------------ $ git diff topic master <1> $ git diff topic..master <2> $ git diff topic...master <3> ------------ + <1> Changes between the tips of the topic and the master branches. <2> Same as above. <3> Changes that occurred on the master branch since when the topic branch was started off it. ---8<---
I think <3> should be changed in something like: <3> Changes between the tips of the topic and the master branch that occurred since when the topic branch was started off it.
What do you think?
I would like to add some graphical representation of <2> and <3> but I'm a bit loss with <3> (and I guess lot of newbies are not really understanding that point). Can anybody come up with some ASCII art?
Thanks.
Ciao,
-- Paolo http://paolo.ciarrocchi.googlepages.com/