Re: [gentoo-dev] Some suggestions

[Steven Elling]

On Sunday 07 September 2003 03:19, Troy Dack wrote:
> On Sun, 2003-09-07 at 15:59, Jan Krueger wrote:
> > On Sunday 07 September 2003 03:08, Martin Schlemmer wrote:
> > > Come on guys, think what is best for the *distro* (meaning,
> > > what will work best for the other 90% of users,
>
> I'd say 95% of user, but that's just me :P
>
> > From my point of view the best for the 90% of users in this case
> > (make.conf) would be:
> > 1. a very precise documentation with examples about the user settable
> > things for make.conf thats accessable via a standard command, like man
> > make.conf or info make.conf
>
> How imprecise and unaccessible is:
>
> 	nano -w /etc/make.conf
>
> All settings are commented, and commented well, and it's available using
> standard commands (you could even use ed or a combination of cat, less,
> head & tail if you really wanted to)

And duplicated in the make.conf man page.  Why duplicate documentation in 
two different places and open the door to discrepancies between them?  
Also, shouldn't we teach by example the proper places to get documentation 
instead of creating a reliance on 'self documented' config files?


--
gentoo-dev@g.o mailing list