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