Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 14 Oct 2005 13:29:52 -0700
From:      Doug Barton <dougb@FreeBSD.org>
To:        "Bjoern A. Zeeb" <bz@FreeBSD.org>
Cc:        cvs-src@FreeBSD.org, src-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/share/man/man5 make.conf.5
Message-ID:  <43501540.4000107@FreeBSD.org>
In-Reply-To: <Pine.BSF.4.53.0510130545231.7065@e0-0.zab2.int.zabbadoz.net>
References:  <200510121905.j9CJ5Mrx063823@repoman.freebsd.org> <434DCAC0.7040909@FreeBSD.org> <Pine.BSF.4.53.0510130545231.7065@e0-0.zab2.int.zabbadoz.net>

next in thread | previous in thread | raw e-mail | index | archive | help
Bjoern A. Zeeb wrote:

> This cause has been documented in nsswitch.conf(5) for more than half a year.
> That time it was thought that might be the best place.

I'm sure that the people who are familiar with the issue had a reasonable
train of thought there.

>>Could you please add a comment in /usr/share/examples/etc/make.conf to this
>>effect as well?
> 
> 
> Do we really need this? It's documented in make.conf.5 now and there
> might be source changes in the future so that changes might not be
> needed at all. Adding a comment to yet another file means to update
> yet another file in case anything changes and this is easily
> forgotten. 

Yes, I think it's needed. A lot of people who update make.conf don't read
the man page. Also, while your point about multiple references is a good
one, it shouldn't be _that_ hard to keep it together.

> I'm not saying I won't do it if forced to..;)

No one is forcing anything. I'm happy to do it if you don't feel right doing
it for whatever reason.

hth,

Doug



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?43501540.4000107>