Re: [Fwd: Re: [PHP-DOC] restructurung function reference]

From: Date: Fri, 07 Jan 2005 14:24:05 +0000
Subject: Re: [Fwd: Re: [PHP-DOC] restructurung function reference]
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969365855@lists.php.net to get a copy of this message
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 ... So, do we modifiy the DTD and leave docbook ?
didou

« previous php.doc (#969365855) next »