From owner-freebsd-arch@FreeBSD.ORG Tue Mar 30 07:05:34 2004 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 43EC016A4CE; Tue, 30 Mar 2004 07:05:34 -0800 (PST) Received: from smtp.des.no (flood.des.no [217.116.83.31]) by mx1.FreeBSD.org (Postfix) with ESMTP id 08AD043D39; Tue, 30 Mar 2004 07:05:34 -0800 (PST) (envelope-from des@des.no) Received: by smtp.des.no (Pony Express, from userid 666) id E1F415309; Tue, 30 Mar 2004 17:05:32 +0200 (CEST) Received: from dwp.des.no (des.no [80.203.228.37]) by smtp.des.no (Pony Express) with ESMTP id 7FBAC5308; Tue, 30 Mar 2004 17:05:24 +0200 (CEST) Received: by dwp.des.no (Postfix, from userid 2602) id 63AAC33CAA; Tue, 30 Mar 2004 17:05:24 +0200 (CEST) To: Alexey Zelkin References: <20040328094048.GA40406@phantom.cris.net> From: des@des.no (Dag-Erling =?iso-8859-1?q?Sm=F8rgrav?=) Date: Tue, 30 Mar 2004 17:05:24 +0200 In-Reply-To: <20040328094048.GA40406@phantom.cris.net> (Alexey Zelkin's message of "Sun, 28 Mar 2004 12:40:48 +0300") Message-ID: User-Agent: Gnus/5.090024 (Oort Gnus v0.24) Emacs/21.3 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on flood.des.no X-Spam-Level: X-Spam-Status: No, hits=0.0 required=5.0 tests=AWL autolearn=no version=2.63 cc: arch@FreeBSD.org Subject: Re: CFD: XMLification of NOTES X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Mar 2004 15:05:34 -0000 Alexey Zelkin writes: > This weekend I have got some spare time (due to illness) and in > order to get some rest from current tasks decided to pass thru old > TODO file. Most interesting task got my attention was old item > related to XMLification NOTES. > > Important advantage of this step (IMO) is to provide possibility to > check dependency/conflicts of kernel configuration file to end users. > [...] NOTES is not intended as a list of supported device and options. We have src/sys/conf/files* and src/sys/conf/options* for that. Dependencies between loadable drivers and subsystems are documented in the source code (MODULE_DEPEND), though that information is not used at compile time. Dependencies that involve non-loadable drivers and subsystems are not documented anywhere (except sometimes in manual pages). It would not be hard to modify config(8) to obtain that information from e.g. src/sys/conf/depend*. I might even come up with a patch if I'm bored. NOTES used to be called LINT until Someone[tm] misguidedly decided to add hints to it (which made it unusable as a config file) instead of putting them in e.g. LINT.hints (just like GENERIC.hints for GENERIC). This was IMHO a mistake, but regardless, that file has two purposes: primarily, to server as a kernel config that includes as much code as possible to simplify automated build tests, and secondarily, to document some of the more obscure options (the less obscure ones are documented in manual pages). DES --=20 Dag-Erling Sm=C3=B8rgrav - des@des.no