svn: head/sys/i386/conf

[Luigi Rizzo]

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