git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[RFD] How to better document the "two and three dots" format

From
PCPaolo 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/
Next: Mikael Magnusson
Message 1 of 3 in “[RFD] How to better document the "two and three dots" format”
  1. Paolo CiarrocchiSep 1, 2008
  2. Mikael MagnussonSep 1, 2008
  3. Daniël GressmannSep 1, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.