From owner-freebsd-doc Tue Jan 5 06:05:29 1999 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id GAA18142 for freebsd-doc-outgoing; Tue, 5 Jan 1999 06:05:29 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from as5200-01-254.no.neosoft.com (as5200-01-254.no.neosoft.com [206.27.167.254]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id GAA18136 for ; Tue, 5 Jan 1999 06:05:26 -0800 (PST) (envelope-from conrads@as5200-01-254.no.neosoft.com) Received: (from conrads@localhost) by as5200-01-254.no.neosoft.com (8.9.1/8.8.7) id IAA00919; Tue, 5 Jan 1999 08:04:14 -0600 (CST) (envelope-from conrads) Message-ID: X-Mailer: XFMail 1.3 [p0] on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <65049.915509018@zippy.cdrom.com> Date: Tue, 05 Jan 1999 08:04:14 -0600 (CST) Reply-To: conrads@neosoft.com From: Conrad Sabatier To: "Jordan K. Hubbard" Subject: Re: Kernel configuration docs a neglected area? Cc: doc@FreeBSD.ORG Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On 05-Jan-99 Jordan K. Hubbard wrote: [I had written] >> While I realize the development team already has its hands full and can >> hardly afford the time to meticulously document each and every possible >> kernel configuration line, it still seems to me nonetheless that this is >> one area that simply cries out for more attention. > > Sure does. > >> How this might be achieved is, of course, another matter altogether. >> :-) > > You were going to contribute the aformentioned docs, you simply forgot > to hit the "attach" button on your netscape mail client ^^^^^^^^^^^^^^^^^^^^ Ick! :-) > and include > them with your comments. Please try again. :-) But you see, that's the problem. I'd gladly help out with this (writing that AWE setup tutorial has whet my appetite for doc-writing), but there are still too many things in LINT that aren't totally clear to me (I'm sure I'm not alone in this), and where to find the needed information is fairly mysterious in some cases. Perhaps if each person responsible for item X in LINT could simply provide a pointer to any existing documentation for their particular contribution, a simple "see man X" or "see /usr/share/doc/foo/X" in LINT, might at least get us off to a decent start. I'm just grabbing at any possiblity here. :-) Incidentally, if you've checked out my AWE tutorial and see no problems with it, feel free to include a pointer to it in LINT, if you like: http://www.neosoft.com/~conrads/awepnp-freebsd.txt -- Conrad Sabatier Individualists unite! To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message