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 ?
I think we should not do that, if the jade people suggest something else, which might work too.
It is always a question of what the rendering becomes, and how much does it need to be modified (XSLT, DSSSL, Livedocs). Using sections as suggested in the thread pointed out by Nuno might lead to unexpected results. Have someone tried that out actually in a small test phpdoc document?
Goba
