From owner-freebsd-doc@FreeBSD.ORG  Sun Aug  1 06:21:01 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id AE9A716A4CF; Sun,  1 Aug 2004 06:21:01 +0000 (GMT)
Date: Sun, 1 Aug 2004 06:21:01 +0000
From: Murray Stokely <murray@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Message-ID: <20040801062101.GF27954@hub.freebsd.org>
References: <20040728205248.GI424@submonkey.net>
	<20040728230100.GE79225@abigail.blackend.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040728230100.GE79225@abigail.blackend.org>
User-Agent: Mutt/1.4.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
cc: Ceri Davies <ceri@FreeBSD.org>
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: Sun, 01 Aug 2004 06:21:01 -0000

On Thu, Jul 29, 2004 at 01:01:00AM +0200, Marc Fonvieille wrote:
> > 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.

Yes I agree that the second is better.  I have done my fair share of
moving around <sectN>s to different levels, and the effort in changing
two characters in that instance is well worth the enhanced readability
over just <section> tags.

     - Murray