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

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 1, 2007, 09:40 UTC
Message-ID: <7vabs6u3jt.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <hcmesrse.fsf@cante.net>

Jari Aalto <jari.aalto@cante.net> writes:

Show 9 quoted lines

> Like:
>
>     HEAD, HEAD~1, HEAD~2
>
> If the syntax is changed in the middle (as it was in manual page),
> that interrupts the kognitive flow of reading.
>
>     HEAD, HEAD^, HEAD~2
>

I still would prefer to teach people HEAD^ earlier. If you _REALLY_ insist, I can live with spelling the HEAD~2 as HEAD^^ for consistency.

Wasn't with you that earlier I discussed that very basic things such as revision naming and range notation should be moved from rev-list documentation to more central place, and sructure the documentation in such a way that these should be read even before individual manual pages are consulted? If we follow that, then by the time people read these examples, they _ought_ to know that HEAD~1 is a longer-to-type way to say HEAD^ already.