Jari Aalto <jari.aalto@xxxxxxxxx> 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. - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
