From owner-freebsd-doc@FreeBSD.ORG  Wed Jul 28 21:26:50 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 78DA016A4CE; Wed, 28 Jul 2004 21:26:50 +0000 (GMT)
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id E4BEF43D5D; Wed, 28 Jul 2004 21:26:49 +0000 (GMT)
	(envelope-from trhodes@FreeBSD.org)
Received: from localhost (acs-24-154-239-141.zoominternet.net
	[24.154.239.141])	(authenticated bits=0)
	by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6SLQlWM098307
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Wed, 28 Jul 2004 17:26:48 -0400 (EDT)
	(envelope-from trhodes@FreeBSD.org)
Date: Wed, 28 Jul 2004 17:27:18 -0400
From: Tom Rhodes <trhodes@FreeBSD.org>
To: Ceri Davies <ceri@FreeBSD.org>
Message-Id: <20040728172718.3bb7f557@localhost>
In-Reply-To: <20040728205248.GI424@submonkey.net>
References: <20040728205248.GI424@submonkey.net>
X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
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: Wed, 28 Jul 2004 21:26:50 -0000

On Wed, 28 Jul 2004 21:52:48 +0100
Ceri Davies <ceri@freebsd.org> 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.

While I know that DocBook supports both forms, at least from
the last *I* checked.  Last time I checked == a long time ago.

My vote will be for the latter of these two examples, fewer
meaningless changes later.

-- 
Tom Rhodes