Re: cvs: phpdoc /en/reference/domxml/functions DomXsltStylesheet-process.xml domxml-xslt-stylesheet-doc.xml domxml-xslt-stylesheet-file.xml
domxml-xslt-stylesheet.xml
| From: | Gabor Hojtsy | Date: | Wed, 31 Jul 2002 13:44:30 +0000 |
| Subject: | Re: cvs: phpdoc /en/reference/domxml/functions DomXsltStylesheet-process.xml domxml-xslt-stylesheet-doc.xml domxml-xslt-stylesheet-file.xml domxml-xslt-stylesheet.xml |
||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969347732@lists.php.net to get a copy of this message | ||
> > > would it make sense to have all xml files with lower case names?
> > > I notice this particularly with domxml stuff.
> >
> > Well, DomXML is special in phpdoc (similarly to ming) where
> > we have classes and methods, but not functions... How they
> > are currently documented is not the best way to go (as discussed
> > earlier at the documentation meeting). So the documentation should
> > be reorganized to use DocBook 4 OO features and not simply document
> > class methods as PHP functions...
>
> Since this was my more or less first commit to phpdoc, I was not very
> sure, if I did it the right way :) But it looks like others had the same
> problems (meaning with methods not functions). I would be very happy, if
> there will be a solution to this problem. Or is there already one?
DocBook 4 has support for OO documentation. However, as far as I know,
the rendering is not too cute so it should be enhanced. But I have too
many things to do now here in phpdoc, so I can only add it to the bottom
of my TODO list (BWT it's already in the metting protocol and maybe in
the TODO too). See phpdoc/RFC and phpdoc/TODO
Goba