From owner-freebsd-doc@FreeBSD.ORG  Wed Jul 28 23:01:04 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 4E47616A4CE; Wed, 28 Jul 2004 23:01:04 +0000 (GMT)
Received: from abigail.blackend.org (blackend.org [212.11.35.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 410FC43D5A; Wed, 28 Jul 2004 23:01:03 +0000 (GMT)
	(envelope-from marc@blackend.org)
Received: from abigail.blackend.org (localhost [127.0.0.1])
	i6SN11cP092646;	Thu, 29 Jul 2004 01:01:01 +0200 (CEST)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6SN10Zb092644;
	Thu, 29 Jul 2004 01:01:00 +0200 (CEST)
	(envelope-from marc)
Date: Thu, 29 Jul 2004 01:01:00 +0200
From: Marc Fonvieille <blackend@FreeBSD.org>
To: Ceri Davies <ceri@FreeBSD.org>, doc@FreeBSD.org
Message-ID: <20040728230100.GE79225@abigail.blackend.org>
References: <20040728205248.GI424@submonkey.net>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="3V7upXqbjpZ4EhLz"
Content-Disposition: inline
In-Reply-To: <20040728205248.GI424@submonkey.net>
User-Agent: Mutt/1.4.2.1i
X-Useless-Header: blackend.org
X-Operating-System: FreeBSD 4.10-PRERELEASE
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 23:01:04 -0000


--3V7upXqbjpZ4EhLz
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jul 28, 2004 at 09:52:48PM +0100, Ceri Davies wrote:
>=20
> Which of these do we prefer?
>=20
> 1) <section>
>      <para>foo</para>
>      <section>
>        <para>bar</para>
>      </section>
>    </section>
>=20
> 2) <sect1>
>      <para>foo</para>
>      <sect2>
>        <para>bar</para>
>      </sect2>
>    </sect1>
>
[...]

The 2nd one is maybe better when it comes to think about indentation
levels.  And when you are reading a large SGML file it can be useful to
know "where" a section will be rendered, even if the indentation is not
correct you know where you are, with 1st form it may be more difficult.

Marc

--3V7upXqbjpZ4EhLz
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (FreeBSD)

iD8DBQFBCDAq81T1MWxkgcoRAnosAJ9nOBtO2pZSJGIO0a7iBTsw9klobQCffU/V
o6awYsn/EdmkJjGDqoInZDQ=
=lwJA
-----END PGP SIGNATURE-----

--3V7upXqbjpZ4EhLz--