From: Nicolas Sebrecht <nicolas.s.dev@gmx.fr>
Date: Thu, 20 Jan 2011 23:16:49 GMT
Subject: Re: Parameter --color-words not documented for "git show"
Message-ID: <20110120231649.GC14184@vidovic>
In-Reply-To: <7vk4hzqnbx.fsf@alter.siamese.dyndns.org>

The 20/01/11, Junio C Hamano wrote:
> Sebastian Pipping <webmaster@hartwork.org> writes:
> 
> > On 01/20/11 21:27, Thomas Rast wrote:
> >> Quote from the latter:
> >> 
> >>        This manual page describes only the most frequently used options.
> >
> > Okay.  Is that a good a idea?
> 
> Yes; the alternative is to list everything.

Would it be bad? I tend to think that a manual page is the good place to
list everything the program accepts as parameters and how to use them.
FMHO, Manual page is not where newcomers look to learn but it should
help everybody to find and understand all of the available options.

-- 
Nicolas Sebrecht