Re: Re: phpdoc function reference grouping
| From: | Gabor Hojtsy | Date: | Sat, 27 Jul 2002 12:00:26 +0000 |
| Subject: | Re: Re: phpdoc function reference grouping | ||
| References: | 1 2 | Groups: | php.doc php.gtk.doc |
| Request: | Send a blank email to phpdoc+get-969347618@lists.php.net to get a copy of this message | ||
> 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