Re: [PATCH] Mention the fact that 'git annotate' is only for backward compatibility.
From: Petr Baudis <hidden>
Date: 2016-06-15 22:45:19
On Fri, Sep 05, 2008 at 12:29:51AM -0700, Junio C Hamano wrote:
quoted hunk ↗ jump to hunk
diff --git c/Documentation/git-annotate.txt w/Documentation/git-annotate.txt index 8b6b56a..78dc5e2 100644 --- c/Documentation/git-annotate.txt +++ w/Documentation/git-annotate.txt@@ -14,6 +14,11 @@ DESCRIPTION Annotates each line in the given file with information from the commit which introduced the line. Optionally annotate from a given revision. +The only difference from this command and linkgit:git-blame[1] is that
^^^^ between?
+they use slightly different output formats, and this command exists only +for backward compatibility to support existing scripts, and provide more +familiar command name for people coming from other SCM systems. + OPTIONS ------- include::blame-options.txt[]
I like this one. I'm still not too happy about leaving the command in the command list and tab completion since I believe reducing the number of commands (which is still quite intimidating for the user), even just by a little, is more important than encouraging people to use compatibility aliases. I don't feel very strongly about it, though. Acked-by: Petr Baudis <redacted>