From owner-freebsd-doc Sat Jan 4 0: 4:38 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 1E80937B401 for ; Sat, 4 Jan 2003 00:04:37 -0800 (PST) Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 07A9E43EE5 for ; Sat, 4 Jan 2003 00:04:36 -0800 (PST) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-a172.otenet.gr [212.205.215.172]) by mailsrv.otenet.gr (8.12.6/8.12.6) with ESMTP id h0484S4V000146; Sat, 4 Jan 2003 10:04:30 +0200 (EET) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.6/8.12.6) with ESMTP id h0484Sh2005485; Sat, 4 Jan 2003 10:04:28 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.12.6/8.12.6/Submit) id h0484SPB005484; Sat, 4 Jan 2003 10:04:28 +0200 (EET) (envelope-from keramida@freebsd.org) Date: Sat, 4 Jan 2003 10:04:28 +0200 From: Giorgos Keramidas To: Nick Rogness Cc: Lucky Green , l.rizzo@iet.unipi.it, doc@freebsd.org Subject: Re: IPFW: suicidal defaults Message-ID: <20030104080428.GA5322@gothmog.gr> References: <20030103212617.GC2505@gothmog.gr> <20030103195642.G6257-100000@skywalker.rogness.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030103195642.G6257-100000@skywalker.rogness.net> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On 2003-01-03 20:01, Nick Rogness wrote: > On Fri, 3 Jan 2003, Giorgos Keramidas wrote: > > > Agreed. There should be a mention. However, someone has to write > > > it. Instead of bitchin about it, go ahead and submit a change > > > (bug report). > > > > Oh but it is documented. The sample configuration that one can find > > at /usr/src/sys/i386/conf/LINT includes a comment: > > [...] > > Ignoring this is not a fault of the documentation :( > > You are right. The documentation is there. However, finding this > is not easy for a beginner. It wouldn't hurt to mention it > ipfw(8) and the handbook. > > But that takes work and is redundant :-) Actually, no work is redundant. All the help you can give in improving our documentation is welcome, and much appreciated. In this particular case, all the references I could find to LINT in the kernelconfig/chapter.sgml chapter of the handbook were: [ Quoting doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml ] %% 411 id="kernelconfig-options"> An exhaustive list of options and more 412 detailed explanations of the device lines is present in the 413 LINT configuration file, located in the same 414 directory as GENERIC. If you are in doubt as 415 to the purpose or necessity of a line, check first in 416 LINT. %% 441 closely. For details of all the possible kernel options, see 442 /usr/src/sys/i386/conf/LINT. ... The first paragraph looks like it needs a bit of toning up, in order to be more obvious and stand out. But some doumentation *is* there. If you think that it can be improved, then please, by all means, help us improve it. Post your changes to the freebsd-doc list or file a problem report under the ``docs'' category. - Giorgos To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message