From owner-cvs-src@FreeBSD.ORG Thu Aug 31 00:42:22 2006 Return-Path: X-Original-To: cvs-src@FreeBSD.org Delivered-To: cvs-src@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3E0C116A4DA; Thu, 31 Aug 2006 00:42:22 +0000 (UTC) (envelope-from gad@FreeBSD.org) Received: from smtp5.server.rpi.edu (smtp5.server.rpi.edu [128.113.2.225]) by mx1.FreeBSD.org (Postfix) with ESMTP id C709D43D45; Thu, 31 Aug 2006 00:42:21 +0000 (GMT) (envelope-from gad@FreeBSD.org) Received: from [128.113.24.47] (gilead.netel.rpi.edu [128.113.24.47]) by smtp5.server.rpi.edu (8.13.1/8.13.1) with ESMTP id k7V0gJtw026764; Wed, 30 Aug 2006 20:42:20 -0400 Mime-Version: 1.0 Message-Id: In-Reply-To: <20060830192456.2497b4bd.trhodes@FreeBSD.org> References: <200608290920.k7T9KmV9067843@repoman.freebsd.org> <86zmdmfoow.fsf@dwp.des.no> <20060830202834.GA11284@rambler-co.ru> <20060830192456.2497b4bd.trhodes@FreeBSD.org> Date: Wed, 30 Aug 2006 20:42:19 -0400 To: Tom Rhodes , Ruslan Ermilov From: Garance A Drosehn Content-Type: text/plain; charset="us-ascii" ; format="flowed" X-CanItPRO-Stream: default X-RPI-SA-Score: undef - spam-scanning disabled X-Scanned-By: CanIt (www . canit . ca) Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: "Chatty" config files in /etc X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 31 Aug 2006 00:42:22 -0000 On Aug 30/06, Tom Rhodes asks the reasonable question: >On Thu, 31 Aug 2006 00:28:34 +0400 >Ruslan Ermilov wrote: > > > On Wed, Aug 30, 2006 at 01:41:51PM -0400, Garance A Drosehn wrote: > > > >> > I do think those comments and examples are useful, but it might be > > > better to move those lines into separate files. > > > > I think they should be moved to /usr/share/examples/etc/ (like >> make.conf), with files in /etc/ representing good (short) defaults > > with a minimum of comments and probably references to examples. > >Question is, what files will be moved? All configuration files >or just "some" ? I would not move "all" of them. I think the proper rule would be "Split up the ones which constantly annoy me when they change". Obviously that's a rather subjective criteria... We could pick off a few and change those, and then see if there are anymore which should be split up. My list would be: /etc/hosts /etc/hosts.allow /etc/pf.conf /etc/printcap These are files which have "too many" helpful comments or examples in them, and which I have to modify on every single machine I ever bring up. So *every* time one of these changes, I have to stop and stare at the diff in the mergemaster step, and 99% of the time the change is just to fix or improve some comment. And in many cases, the change is to some line that I remove in my custom copy. Now all of those changes seem to be good changes, but they are still an annoyance when it comes to merging in my local changes. I've also had a vague plan to split up /etc/newsyslog.conf, but in that case most of the lines I want to move are "real" lines (not comments), so that requires some coding changes to make it work the way I'd want it to work. -- Garance Alistair Drosehn = drosehn@rpi.edu Senior Systems Programmer or gad@FreeBSD.org Rensselaer Polytechnic Institute; Troy, NY; USA