On 04/26/2007 01:45 AM, Gwynne Raskind wrote:
Hmm... For some reason I missed that in my searches. That being said,
the existence of one doesn't preclude the writing of another :).
Also, it seems the official documentation in the PHP manual could use
some serious updating, which I would also be willing to undertake if
people think that would be more useful.
Actually I've been recently thinking of adding some kind of documentation to
the sources.
Surely this is not supposed to be something similar to php.net/manual/, just short
descriptions of functions and their arguments, which can be used as a start for the "real"
documentation.
But I wasn't lucky enough to find a utility that would fit my (personal) needs.
Doxygen (which seems to be uses by the majority of F/OSS projects) generates
completely unreadable docs.
Every time I look into ICU docs (generated by Doxygen) I get lost for 10
minutes trying to find a function _by name_.
In the same time, other tools do not provide such a wide range of output
formats as available in Doxygen.
Anyways ZE internals documentation definitely needs serious update and this
would be very much appreciated.
The only problem is that you need to know the internals a bit (or at least want to learn it) to be
able to document it, and all the people with this knowledge are busy with other things most of the time..
You can count on me if you need any help/hints, though.
--
Wbr,
Antony Dovgal
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
