From owner-freebsd-doc@FreeBSD.ORG  Thu Sep 15 15:14:05 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 6A7BD16A430;
	Thu, 15 Sep 2005 15:14:05 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CC22343D49;
	Thu, 15 Sep 2005 15:14:04 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
	(SMTPD32-8.05) id AFB644480034; Thu, 15 Sep 2005 08:13:58 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j8FFFI61082512;
	Thu, 15 Sep 2005 08:15:18 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j8FFFDKc082511;
	Thu, 15 Sep 2005 08:15:13 -0700 (PDT)
	(envelope-from garys@opusnet.com)
To: Tom Rhodes <trhodes@FreeBSD.org>
References: <20050915062312.73803494@localhost>
From: garys@opusnet.com (Gary W. Swearingen)
Date: Thu, 15 Sep 2005 08:15:13 -0700
In-Reply-To: <20050915062312.73803494@localhost> (Tom Rhodes's message of
	"Thu, 15 Sep 2005 06:23:12 -0400")
Message-ID: <x2irx2fjlq.rx2@mail.opusnet.com>
User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.17 (Jumbo Shrimp,
	berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
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 <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 15 Sep 2005 15:14:05 -0000

Tom Rhodes <trhodes@FreeBSD.org> 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.

> +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.

> +.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.