Return-path: <hartmut@php.net>
Received: from mailgate.mysql.com (mailgate2.mysql.com [213.136.52.47])
	by server.barthazi.hu (Postfix) with ESMTP id 8FE7E24A8C	for
 <gabor@hojtsy.hu>; Fri, 07 Jan 2005 12:31:40 +0100 (CET)
Received: from localhost (localhost.localdomain [127.0.0.1])
	by mailgate.mysql.com (8.12.10/8.12.10) with ESMTP id j07BVej9009954	for
 <gabor@hojtsy.hu>; Fri, 07 Jan 2005 12:31:40 +0100
Received: from mail.mysql.com ([10.222.1.99])
 by localhost (mailgate.mysql.com [10.222.1.98]) (amavisd-new, port 10026)
 with LMTP id 08276-02 for <gabor@hojtsy.hu>; Fri,
 07 Jan 2005 12:31:40 +0100 (CET)
Received: from [192.168.1.2] (mailsend.mysql.com [10.100.1.123])
	(authenticated bits=0)	by mail.mysql.com (8.12.10/8.12.10)
 with ESMTP id j07BVViL002798	for <gabor@hojtsy.hu>; Fri,
 07 Jan 2005 12:31:31 +0100
Date: Fri, 07 Jan 2005 12:31:25 +0100
From: Hartmut Holzgraefe <hartmut@php.net>
Subject: Re: [PHP-DOC] restructurung function reference
In-reply-to: <41D98FFA.5080407@hojtsy.hu>
To: Gabor Hojtsy <gabor@hojtsy.hu>
Reply-to: hartmut@php-groupies.de
Message-id: <41DE730D.3030809@php.net>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-Accept-Language: en, de
Delivered-to: goba@server.barthazi.hu
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8a3) Gecko/20040817
X-Virus-Scanned: by amavisd-new at mailgate.mysql.com
X-Spam-Checker-Version: SpamAssassin 3.0.2 (2004-11-16) on wish.hu
X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00 autolearn=ham
	version=3.0.2
X-Spam-Level:
References: <1104734421.23529.156.camel@beethoven.site>
 <41D935F6.90100@hojtsy.hu> <1104769532.5374.16.camel@beethoven.site>
 <41D98FFA.5080407@hojtsy.hu>

Gabor Hojtsy wrote:
>> I changed mysqli a little bit (<reference> to <chapter> and <section> to
>> <sect1>. For an example see http://www.php-award.net/mysqli/index.html
> 
> 
> This does not seem to be that bad :) I wonder what were the good points 
> on using reference instead of chapter here... Chapter seems to be able 
> to contain a <refentry> just fine:
> 
>   http://docbook.org/tdg/en/html/chapter.html
> 
> Would be nice to validate your resulting XML against the used docbook 
> version's DTD.

I have played with this before and as far as i remember the problem is
that only a certain order of <section> and <refentry> tags is allowed
within <chapter> by the DocBook DTD

AFAIR DSSSL is not too picky when it comes to DTD issues like this
while XSLT and "make test" will complain heavily

Anyway, i have considered this approach as a failed experiment in the
past ...

-- 
Hartmut Holzgraefe  <hartmut@php.net>