Re: [PATCH 2/7] Undocument deprecated alias 'push.default=tracking'

From: Jonathan Nieder <jrnieder@gmail.com>
Date: Jan 31, 2013, 19:07 UTC
Message-ID: <20130131190747.GE27340@google.com>
In-Reply-To: <7vvcadgss0.fsf@alter.siamese.dyndns.org>

Hi,

Junio C Hamano wrote:

Show 5 quoted lines

> Wow, that's a blast from the past.
>
> I tend to agree that deprecating and removing are quite different,
> but a simple "revert" of the change would not be good, either.  We
> still would want to _discourage_ its use.

Hm, I was about to try adding a line in that vein, like

 * `tracking` - deprecated synonym for `upstream`.
 
Imagine my surprise when I saw that that is what you just said
would be no good:

[...]

>>>    `git pull`.
>>> -* `tracking` - deprecated synonym for `upstream`.
>>>  * `current` - push the current branch to a branch of the same name.

I really do think that including `tracking` in the same list would be valuable. When I look over a friend's .gitconfig file to help track down a problem she is running into, it is helpful if I can find the meaning of each item in a straightforward way.

Is the problem that "deprecated" is not precise enough? For example, would it make sense to say "deprecated synonym for `upstream`. Will be dropped in git 2.1" or something like that?

My two cents, Jonathan