From: Junio C Hamano <gitster@pobox.com>
Date: Wed, 10 Nov 2010 00:32:55 GMT
Subject: Re: [PATCHv2] Doc: git-push: Specify the default mode in the description
Message-ID: <7vd3qej9vs.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1289305497-13883-1-git-send-email-santi@agolina.net>

Santi Béjar <santi@agolina.net> writes:

> Text extracted from the <refspec> option.

Perhaps I wasn't clear enough.  "extracted" is not something we want.

If you think "'matching' is the default" is so important than anything
else, explaining it upfront _might_ be a good idea, but then why leave the
original description only to repeat the same thing again?

It would be an improvement if you rephrased things so that the manual
becomes shorter, non repetitive, and having more important information
easier to find.  Otherwise it's just adding noise on top of noise that
already is there, isn't it?