Re: Current annoyances with PhD
| From: | Hannes Magnusson | Date: | Mon, 03 Dec 2007 10:56:24 +0000 |
| Subject: | Re: Current annoyances with PhD | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969378430@lists.php.net to get a copy of this message | ||
On Dec 1, 2007 8:02 AM, Edward Z. Yang <edwardzyang@thewritingpot.com> wrote:
> Working with PhD's output for object oriented documentation, here are my
> current pet peeves:
>
> * Properties are not inherited in class synopsises (need another crazy
> XPath)
XPointered XInclude, not XPath :P
> * Properties are not linked to their corresponding definitions (linkend
> or better indexing?)
Better indexing+rendering, but linkends are OK as a "workaround"
(don't harm anyway)
> * Types that are classes don't link to the classes' reference page
Good idea, file a bug/feature request? :)
> * We need some way, given a full classsynopsis, to generate a skeleton
> for all the properties below
Generating the XML for php-src classess by scanning the sources is hell.
I had a tiny Reflection script that generated the
old-orginal-skeletons, but the formatting was completly wacked cause I
used ext/dom to write up the XML which fcked up all WS and line breaks
and stuff per our CS :]
> * Method-names need to be formatted prettier (indexer needs to collect
> static information)
Define "prettier"?
-Hannes