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

Tilde spec - befuzzled

From
Luke Diamand <luke@diamand.org>
Date
Feb 28, 2012, 09:07 UTC
Message-ID
<4F4C995D.9000504@diamand.org>

The documentation for caret and tilde specs is making my head hurt, even though they always _do_ exactly what I want. And I thought I understood them until I read more carefully.

   A suffix '{caret}' to a revision parameter means the first parent of
   that commit object.  '{caret}<n>' means the <n>th parent (i.e.
   '<rev>{caret}'
So far, so good.
'<rev>{tilde}<n>', e.g. 'master{tilde}3'::
   A suffix '{tilde}<n>' to a revision parameter means the commit
   object that is the <n>th generation grand-parent of the named
   commit object, following only the first parents.
Hang on, *grand*-parents?

So HEAD~1 won't give me the *parent* commit of HEAD, but the *grandparent* commit of HEAD (following only the first parents) ?

How do I get to the *parent* commit of HEAD? Does that mean that HEAD~ != HEAD^ And why does HEAD~1 always look exactly what I would naively call the 'parent' of HEAD?

I'm pretty sure I'm missing something very obvious. I think it must confuse other people as well though, as it's quite easy to find webpages around that claim that tildes give the _parent_ commit.

Thanks Luke

Next: Andreas Ericsson
Message 1 of 10 in “Tilde spec - befuzzled”
  1. Luke DiamandFeb 28, 2012
  2. Andreas EricssonFeb 28, 2012
  3. Thomas RastFeb 28, 2012
  4. Junio C HamanoFeb 28, 2012
  5. Andrew ArdillFeb 29, 2012
  6. Jeff KingFeb 29, 2012
  7. Andreas EricssonFeb 29, 2012
  8. Andreas EricssonFeb 29, 2012
  9. Re*: Tilde spec - befuzzledJunio C Hamano, Feb 29, 2012
  10. Luke DiamandMar 2, 2012

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.