From owner-freebsd-stable Mon Jan 28 10:14:24 2002 Delivered-To: freebsd-stable@freebsd.org Received: from ns.yogotech.com (ns.yogotech.com [206.127.123.66]) by hub.freebsd.org (Postfix) with ESMTP id D6A1F37B416 for ; Mon, 28 Jan 2002 10:14:20 -0800 (PST) Received: from caddis.yogotech.com (caddis.yogotech.com [206.127.123.130]) by ns.yogotech.com (8.9.3/8.9.3) with ESMTP id LAA29408; Mon, 28 Jan 2002 11:14:19 -0700 (MST) (envelope-from nate@yogotech.com) Received: (from nate@localhost) by caddis.yogotech.com (8.11.6/8.11.6) id g0SIEJP68406; Mon, 28 Jan 2002 11:14:19 -0700 (MST) (envelope-from nate) From: Nate Williams MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <15445.38139.56874.444902@caddis.yogotech.com> Date: Mon, 28 Jan 2002 11:14:19 -0700 To: Justin White Cc: nate@yogotech.com (Nate Williams), freebsd-stable@FreeBSD.ORG Subject: Re: firewall config (CTFM) In-Reply-To: <6085443A-141A-11D6-AD14-000393092F82@mac.com> References: <15445.34866.827021.644844@caddis.yogotech.com> <6085443A-141A-11D6-AD14-000393092F82@mac.com> X-Mailer: VM 6.96 under 21.1 (patch 14) "Cuyahoga Valley" XEmacs Lucid Reply-To: nate@yogotech.com (Nate Williams) Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG > >> i'm not trying to be mean, but if you don't read the docs > > > > A comment in a configuration file that the user should never have to see > > is considered documentation? > > no, the user _should_ making a point to see that configuration file. if > they're changing /etc/rc.conf, they should be reading the corresponding > defaults file. if they're changing /etc/rc.conf without previously > reading the defaults file, too bad. > > by your logic, when someone configures a new kernel, they shouldn't need > to look at LINT? I doubt most users look at LINT for building their kernels. I rarely do, since it rarely contains information *I* need for my kernels. Only when I add them to my local workstation do I look (for things like sound drivers and such), and more often than not, I need to check the archives or ask a local question since I'm not sure *what* configuration is right for my box. So, in answer to your question, I don't consider /etc/defaults/rc.conf proper documentation, nor do I consider LINT proper documenation. It's better than nothing, but it's not adequate for many tasks. (And, as stated before, what 'documentation' exists for the variable is poorly worded, so the documentation we have currently is not only inadequate, it's bad.) Nate To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message