cvs commit: src/share/man/man5 make.conf.5

Doug Barton dougb at FreeBSD.org
Fri Oct 14 13:30:12 PDT 2005


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


More information about the cvs-src mailing list