Joel Becker wrote:
The suggestions are pretty simple. First, when behavior is changed invisibly (as the remote branch stuff was), can we note it in the documentation? I don't mean the ChangeLog, I mean the manpage.
Please, no. I understand where you're coming from with this request, but think of it from the point of view of non-long-time users (or users who have been keeping up with the changelog) who want to look up some piece of information. The last thing they want to have to do is read through a bunch of irrelevant information related to the behavior of obsolete versions of git they've never even used.
I guess I would be fine with the idea of the manpages saying something like, "Note: This is new as of version 1.X.Y; see git-changelog(7)." But that's as much intrusion from old versions of the software as I'd want in the reference manual, which is what the manpages really are.
-Steve - 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