Re: Documenting the Zend2 extension API
| From: | Wez Furlong | Date: | Tue, 29 May 2007 23:41:38 +0000 |
| Subject: | Re: Documenting the Zend2 extension API | ||
| References: | 1 2 3 4 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-29911@lists.php.net to get a copy of this message | ||
We use doxygen for the developer portions of our customer facing
manual. The trick is to have it output xml and then massage that to
fit into docbook.
--Wez.
On 4/25/07, Antony Dovgal <antony@zend.com> wrote:
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.