From owner-freebsd-doc@FreeBSD.ORG  Thu Sep 15 17:11:01 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 5CB2A16A41F;
	Thu, 15 Sep 2005 17:11:01 +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 078AF43D46;
	Thu, 15 Sep 2005 17:11:00 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
	(SMTPD32-8.05) id AB20177200D0; Thu, 15 Sep 2005 10:10:56 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j8FHCHgM084310;
	Thu, 15 Sep 2005 10:12:17 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j8FHCCJR084309;
	Thu, 15 Sep 2005 10:12:12 -0700 (PDT)
	(envelope-from garys@opusnet.com)
To: Giorgos Keramidas <keramida@ceid.upatras.gr>
References: <20050915062312.73803494@localhost>
	<20050915132925.GA1370@flame.pc>
From: garys@opusnet.com (Gary W. Swearingen)
Date: Thu, 15 Sep 2005 10:12:12 -0700
In-Reply-To: <20050915132925.GA1370@flame.pc> (Giorgos Keramidas's message
	of "Thu, 15 Sep 2005 16:29:26 +0300")
Message-ID: <ieaciefe6r.cie@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: Tom Rhodes <trhodes@freebsd.org>, 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 17:11:01 -0000

Giorgos Keramidas <keramida@ceid.upatras.gr> writes:

> On 2005-09-15 06:23, Tom Rhodes <trhodes@freebsd.org> wrote:

>> -.Pa /etc
>> +.Pa /etc/rc.d
>
> Nice catch :)

Maybe want both.  On my 5.4 sys:

/etc/pccard_ether:if [ -r /etc/defaults/rc.conf ]; then
/etc/pccard_ether:      . /etc/defaults/rc.conf
/etc/pccard_ether:      . /etc/rc.conf
/etc/rc.bsdextended:                . /etc/defaults/rc.conf
/etc/rc.bsdextended:                . /etc/rc.conf
/etc/rc.firewall:               . /etc/defaults/rc.conf
/etc/rc.firewall:               . /etc/rc.conf
/etc/rc.sendmail:       . /etc/defaults/rc.conf
/etc/rc.sendmail:       . /etc/rc.conf
/etc/rc.subr:                   . /etc/defaults/rc.conf
/etc/rc.subr:                   . /etc/rc.conf

Or do I have some old files in there?

>> +Configuration variables which control network services such
>> +as NFS are defined below:
>> +.Bl -tag -width indent-two
>
> I think "such as NFS" should be inside a pair of commas here.

Some wouldn't. It's fine either way, IMO.  When I say it out loud, I
pause only after "NFS", but it seems wrong with only one comma.

(I subscribed to alt.usage.english yesterday after 3 years or so, to
maybe ask about such things, but was disappointed to see them 90% off
topic.  I'll have to lurk a while before trusting them again.)

> IMHO, it's also a bug to
> start the line with a capital letter when a displayed block is 'inlined'
> somewhere in the middle of a sentence. 

Yes, and something to watch for, it seems; I fixed one yesterday.