Date: Wed, 7 Jan 2009 01:59:54 +0100 From: Luigi Rizzo <rizzo@iet.unipi.it> To: Maxim Sobolev <sobomax@freebsd.org> Cc: svn-src-head@freebsd.org, Luigi Rizzo <luigi@freebsd.org>, src-committers@freebsd.org, svn-src-all@freebsd.org Subject: Re: svn: head/sys/i386/conf Message-ID: <20090107005954.GA6567@onelab2.iet.unipi.it> In-Reply-To: <4963F92E.1040708@FreeBSD.org> References: <200901061510.n06FAQ0g034585@svn.freebsd.org> <4963D4E9.707@FreeBSD.org> <20090106224658.GB3130@onelab2.iet.unipi.it> <4963F29B.4070001@FreeBSD.org> <20090107003033.GA5795@onelab2.iet.unipi.it> <4963F92E.1040708@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Jan 06, 2009 at 04:37:02PM -0800, Maxim Sobolev wrote: > Luigi Rizzo wrote: ... > >ok, but all we need to say is the following: > > > > The file can contain lines of the form > > > > name = "value" # this is a coment > > > > where whitespace around name and '=' is ignored, and so is > > everything after a '#' character. Almost any printable > > character except '=' is acceptable as part of a name. Quotes > > are optional and necessary only if the value contains > > whitespace. > > > >so why don't we just say that in the kenv(1) manpage (and refer to > >that) instead of referring to loader.conf which contains a lot of > >stuff that does not apply in this case ? > > My main point is that usually people set those tunables not in "hints > files" but in loader.conf, so that if you refer to hints you should also > need to mention loader.conf. In fact I guess that many people may not > even know about what "hints files" are. Point taken. "hints file" is definitely a wrong name and I will rephrase the comment. But I'd like to document things in a way that reduces confusion: /boot/loader and loader.conf are completely out of the loop in processing this config directive (and so they are when processing the "hints" directive), so I don't think they are a good first reference. I think the proper place is one of the kenv([12]) pages, which in turn should mention or refer loader.conf in the same way as it is done in device.hints(5) cheers luigi
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090107005954.GA6567>