From owner-freebsd-doc@FreeBSD.ORG  Mon Aug  2 14:26:47 2004
Return-Path: <owner-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 E8D6016A4F8
	for <freebsd-doc@FreeBSD.org>; Mon,  2 Aug 2004 14:26:44 +0000 (GMT)
Received: from mail2.speakeasy.net (mail2.speakeasy.net [216.254.0.202])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7232343D48
	for <freebsd-doc@FreeBSD.org>; Mon,  2 Aug 2004 14:26:43 +0000 (GMT)
	(envelope-from jhb@FreeBSD.org)
Received: (qmail 3045 invoked from network); 2 Aug 2004 14:26:42 -0000
Received: from dsl027-160-063.atl1.dsl.speakeasy.net (HELO server.baldwin.cx)
	([216.27.160.63])          (envelope-sender <jhb@FreeBSD.org>)
	encrypted SMTP
	for <doc@FreeBSD.org>; 2 Aug 2004 14:26:42 -0000
Received: from 10.50.40.208 (gw1.twc.weather.com [216.133.140.1])
	(authenticated bits=0)
	by server.baldwin.cx (8.12.11/8.12.11) with ESMTP id i72EQau0017473;
	Mon, 2 Aug 2004 10:26:39 -0400 (EDT)
	(envelope-from jhb@FreeBSD.org)
From: John Baldwin <jhb@FreeBSD.org>
To: freebsd-doc@FreeBSD.org
Date: Fri, 30 Jul 2004 15:35:55 -0400
User-Agent: KMail/1.6
References: <20040728205248.GI424@submonkey.net>
	<20040730141505.GV424@submonkey.net>
In-Reply-To: <20040730141505.GV424@submonkey.net>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
Message-Id: <200407301535.55709.jhb@FreeBSD.org>
X-Spam-Checker-Version: SpamAssassin 2.63 (2004-01-11) on server.baldwin.cx
cc: Ceri Davies <ceri@submonkey.net>
cc: doc@FreeBSD.org
Subject: Re: <section> vs. <sectN>
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
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: Mon, 02 Aug 2004 14:26:47 -0000

On Friday 30 July 2004 10:15 am, Ceri Davies wrote:
> On Wed, Jul 28, 2004 at 09:52:48PM +0100, Ceri Davies wrote:
> > Which of these do we prefer?
> >
> > 1) <section>
> >      <para>foo</para>
> >      <section>
> >        <para>bar</para>
> >      </section>
> >    </section>
> >
> > 2) <sect1>
> >      <para>foo</para>
> >      <sect2>
> >        <para>bar</para>
> >      </sect2>
> >    </sect1>
> >
> > This is basically a style issue, as DocBook does the same for both, so
> > whatever the outcome it should probably be added to the FDP.
> >
> > I'll note here that nearly all of our documents use #2 already; I am
> > working on one of the ones that doesn't.
>
> I sense a lack of consensus, so I won't change this particular document.
> Thanks all,

?? It seems that the consensus is for 2).  The only person in favor of 1) is 
DES on the basis that <sectX> is deprecated.  A quick check to see if it is 
indeed deprecated or not should be sufficient to clear this up.

-- 
John Baldwin <jhb@FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
"Power Users Use the Power to Serve"  =  http://www.FreeBSD.org