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

Re: [PATCH] git-reset.txt: Use uniform HEAD~N notation in all examples

From
Junio C Hamano <gitster@pobox.com>
Date
Aug 31, 2007, 19:00 UTC
Message-ID
<7vy7frzfzg.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<tzqfsijk.fsf@cante.net>
Jari Aalto <jari.aalto@cante.net> writes:
> The manual mixed both caret(HEAD^) and tilde (HEAD~N) notation in
> examples. This may be xconfusing to new users. The "counting" notation
> HEAD~N likely to be grasped more easily because it allow successive
> numbering 1, 2, 3 etc.
I am mildly negative on this change.

Referring to (rather, "having to refer to" to fix mistakes) the previous commit happens far more often than referring to an ancestor of an arbitrary generation away (i.e. HEAD~$n). I think it is a better idea to expose users early on that HEAD^ notation which is shorter to type.

Previous: Jari AaltoNext: Jari Aalto
Message 2 of 7 in “git-reset.txt: Use uniform HEAD~N notation in all examples”
  1. git-reset.txt: Use uniform HEAD~N notation in all examplesJari Aalto, Aug 31, 2007
  2. Junio C HamanoAug 31, 2007
  3. Jari AaltoSep 1, 2007
  4. Junio C HamanoSep 1, 2007
  5. Shawn BohrerSep 1, 2007
  6. Jari AaltoSep 1, 2007
  7. Miles BaderSep 3, 2007

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.