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

From: Matthieu Moy <matthieu.moy@imag.fr>
Date: Sep 5, 2008, 06:31 UTC
Message-ID: <vpqaben6r3n.fsf@bauges.imag.fr>
In-Reply-To: <7v63pb3emm.fsf@gitster.siamese.dyndns.org>

Junio C Hamano <gitster@pobox.com> writes:

> Petr Baudis <pasky@suse.cz> writes:
>
>> Can you please also mark it deprecated in the bash completion and
>> command-list.txt?

[...]

Show 5 quoted lines

> 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