> We have no problem with it? :) > > I wouldn't quite go that far, but certainly it's more flexible than > staying with the docbook dtd would have been. The only issues I've come > across are: 1) we had a clash between a docbook.dtd entity and a > phpgtkdoc.dtd entity which went undiagnosed for way too long - make very > sure you don't double up on those. 2) it's less straightforward to add > an element in a modified dtd because you don't have a manual for it (!) > so I'd seriously recommend that whoever writes the modification creates > at least a rough guide to it. 3) where we have sub-functions we've a > still-unresolved problem regarding how to deal with them. I don't > believe this arises anywhere in pure PHP.
These problems are not affecting our decision. I am sure that documentation will exist for the 2) part, but we are still only at deciding whether it's OK to use a modified version [as it seems it's the only way to have reference groupings], so this is initally a really simple modification (though more may be added in the future). Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
