Re: [PATCHv2] Doc: git-push: Specify the default mode in the description
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Nov 10, 2010, 00:32 UTC
- 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?