From owner-freebsd-doc@FreeBSD.ORG Thu Sep 15 23:24:13 2005 Return-Path: X-Original-To: FreeBSD-doc@FreeBSD.org 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 4A0CD16A41F for ; Thu, 15 Sep 2005 23:24:13 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id AFA3943D45 for ; Thu, 15 Sep 2005 23:24:12 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (net-ix.gw.ai.net [205.134.160.6] (may be forged)) (authenticated bits=0) by pittgoth.com (8.13.3/8.13.3) with ESMTP id j8FNOB0X036354 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 15 Sep 2005 19:24:11 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 15 Sep 2005 19:23:13 -0400 From: Tom Rhodes To: garys@opusnet.com (Gary W. Swearingen) Message-ID: <20050915192313.76e9e63a@localhost> In-Reply-To: References: <20050915062312.73803494@localhost> X-Mailer: Sylpheed-Claws 1.9.13 (GTK+ 2.6.8; i386-portbld-freebsd7.0) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: FreeBSD-doc@FreeBSD.org Subject: Re: Reordering the rc.conf manual page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Sep 2005 23:24:13 -0000 On Thu, 15 Sep 2005 08:15:13 -0700 garys@opusnet.com (Gary W. Swearingen) wrote: > Tom Rhodes writes: > > > I've included a patch. It causes a few "empty line" warnings, > > but still gives you the general idea. Comments and suggestions > > are very welcome. > > I got no change to my file after these messages: > Patching file rc.conf.5 using Plan A... > Hunk #1 succeeded at 49. > Hunk #2 succeeded at 73. > patch: **** malformed patch at line 261: script files -into > individual filenames. > > > =================================================================== > > RCS file: /home/ncvs/src/share/man/man5/rc.conf.5,v > > Instead, it is included by the > > various generic startup scripts in > > rm "generic". > > > -.Pa /etc > > +.Pa /etc/rc.d > > which conditionalize their > > rm "alize". Please. > > > internal actions according to the settings found there. > > Found where? "settings found there" -> "variables set in rc.conf". > > > .Nm > > -file: > > +file, classified by section. > > If you think it's worth your time. IMO, it won't help users > much, but it WILL make it look more organized -- a good thing. Yes, I want more organized. It will help me, and perhaps others, if they are looking for a specific option. They can just scroll quick down to the area it should be listed in. > > > +When an configuration variable exists which may fit into > > "an" > "a" > > > +two or more catagories, it will be listed with those which > > spelling > > > +contain the most likeness. > > That sounds like some will be listed in muliple categories. > I hope that's not true. Correct, there will only be one listing of every item. > > > +.Ss DEBUG > > +Configuration variables which enable or disable debugging > > +messages or controls are defined below: > > I don't like "are defined below:". Redundant or something. > Maybe "are defined below." or "are:" > > Whoops; maybe that's not yours. Oh well. > Yea, much of this text is not originally mine. :) -- Tom Rhodes