From owner-freebsd-doc@FreeBSD.ORG  Thu Jul 29 05:25:39 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 D537E16A4CE; Thu, 29 Jul 2004 05:25:39 +0000 (GMT)
Received: from volginfo.ru (ns.volginfo.ru [217.23.84.100])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 2B85F43D4C; Thu, 29 Jul 2004 05:25:39 +0000 (GMT)
	(envelope-from den@FreeBSD.org)
Received: from FreeBSD.org (llp-13.vistcom.ru [217.23.84.68])
	by volginfo.ru (Postfix) with ESMTP
	id E317D2013; Thu, 29 Jul 2004 09:25:31 +0400 (MSD)
Message-ID: <41088A4A.4020401@FreeBSD.org>
Date: Thu, 29 Jul 2004 09:25:30 +0400
From: Denis Peplin <den@FreeBSD.org>
User-Agent: Mozilla/5.0 (X11; U; FreeBSD i386; en-US; rv:1.6) Gecko/20040205
X-Accept-Language: ru, en-us, en
MIME-Version: 1.0
To: Ceri Davies <ceri@FreeBSD.org>
References: <20040728205248.GI424@submonkey.net>
In-Reply-To: <20040728205248.GI424@submonkey.net>
Content-Type: text/plain; charset=us-ascii; format=flowed
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: Thu, 29 Jul 2004 05:25:39 -0000

Hello!

For me 1'st variant looks better.
For example i can skip whole sect1 on first
updating and then include it by searching /sect1
once.
With section's search will stop on each section
included (currently sect2, sect3, sect4) many times.

just my $0.02 :)

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.
> 
> Ceri