From: Junio C Hamano Date: Sat, 01 Sep 2007 09:40:22 GMT Subject: Re: [PATCH] git-reset.txt: Use uniform HEAD~N notation in all examples Message-ID: <7vabs6u3jt.fsf@gitster.siamese.dyndns.org> In-Reply-To: Jari Aalto writes: > 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.