From owner-svn-src-head@FreeBSD.ORG Wed Jan 7 00:54:56 2009 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 7BB81106564A; Wed, 7 Jan 2009 00:54:56 +0000 (UTC) (envelope-from luigi@onelab2.iet.unipi.it) Received: from onelab2.iet.unipi.it (onelab2.iet.unipi.it [131.114.9.129]) by mx1.freebsd.org (Postfix) with ESMTP id 35F8A8FC0C; Wed, 7 Jan 2009 00:54:56 +0000 (UTC) (envelope-from luigi@onelab2.iet.unipi.it) Received: by onelab2.iet.unipi.it (Postfix, from userid 275) id 9D1BE7309E; Wed, 7 Jan 2009 01:59:54 +0100 (CET) Date: Wed, 7 Jan 2009 01:59:54 +0100 From: Luigi Rizzo To: Maxim Sobolev Message-ID: <20090107005954.GA6567@onelab2.iet.unipi.it> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <4963F92E.1040708@FreeBSD.org> User-Agent: Mutt/1.4.2.3i Cc: svn-src-head@freebsd.org, Luigi Rizzo , src-committers@freebsd.org, svn-src-all@freebsd.org Subject: Re: svn: head/sys/i386/conf X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Jan 2009 00:54:57 -0000 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