From: Jonathan Nieder <jrnieder@gmail.com>
Date: Thu, 31 Jan 2013 21:00:02 GMT
Subject: Re: [PATCH 2/7] Undocument deprecated alias 'push.default=tracking'
Message-ID: <20130131210002.GK27340@google.com>
In-Reply-To: <7vobg5f55t.fsf@alter.siamese.dyndns.org>

Junio C Hamano wrote:

> How about doing it this way?
[...]
> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -1795,7 +1795,8 @@ push.default::
>    +
>    This is currently the default, but Git 2.0 will change the default
>    to `simple`.
> -* `upstream` - push the current branch to its upstream branch.
> +* `upstream` - push the current branch to its upstream branch
> +  (`tracking` is a deprecated synonym for this).

I have already explained that I believe this is a bad idea and why and
proposed an alternative.  I take it that either we are
miscommunicating or we fundamentally disagree about the role of
documentation. :(