Re: [PATCH] Mention the fact that 'git annotate' is only for backward compatibility.

Junio C Hamano [off-list ref] writes:

Petr Baudis [off-list ref] writes:

quoted

Can you please also mark it deprecated in the bash completion and
command-list.txt?

[...]

While I do not mind marking annotate as ": infrequently used ;;" in the
completion script, I am skeptical about the value of such a change.
Dropping annotate from the completion is a _slight_ improvement in that
when people type "git a<TAB>" they will see one less candidates, but it is
not a great deal of improvement: four down from five.

Hm, right. Someone used to "$scm annotate" will probably try
"git an<TAB>" and not finding anything there would be misleading
(probably why svn has "annotate" as an alias for "blame").

Mentioning that we support both names for findability in both annotate and
blame manual pages (not just annotate page) might be a better thing to do.

git-blame.txt already somehow has it in the documentation for "-c". I
can't think of a good wording to improve it.

-- 
Matthieu