RE: [PHP-DEV] Documenting the Zend2 extension API

2007-06-04 Thread Andi Gutmans
:[EMAIL PROTECTED] Sent: Friday, June 01, 2007 9:31 PM To: Gwynne Raskind Cc: internals@lists.php.net Subject: Re: [PHP-DEV] Documenting the Zend2 extension API part id=internals2 titleInternals2;/title internals2.intro; internals2.buildsys.index; !-- configure options

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-06-01 Thread Philip Olson
part id=internals2 titleInternals2;/title internals2.intro; internals2.buildsys.index; !-- configure options, ext_skel, config.m4, config.w32, static vs dynamic builds -- internals2.structure.index; !-- ext_skel, module structure, globals, lifecycle, tests --

[PHP-DEV] RE : [PHP-DEV] Documenting the Zend2 extension API

2007-05-30 Thread P
Message- From: Gwynne Raskind [mailto:[EMAIL PROTECTED] Sent: Tuesday, May 29, 2007 11:51 PM To: internals@lists.php.net Subject: Re: [PHP-DEV] Documenting the Zend2 extension API On May 8, 2007, at 2:59 PM, Philip Olson wrote: Hi all, just wanted to give you a heads-up that I'm still

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-05-29 Thread Wez Furlong
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 [EMAIL PROTECTED] wrote: Doxygen (which seems to be uses by the majority of F/OSS projects) generates

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-05-26 Thread Gwynne Raskind
On May 8, 2007, at 2:59 PM, Philip Olson wrote: Hi all, just wanted to give you a heads-up that I'm still working on this project; it took me awhile to get the tools properly set up, but I'm plugging away at DocBook XML now, and I'll have a few patches to send in soon, I think. Thanks for

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-05-08 Thread Philip Olson
On May 5, 2007, at 6:47 PM, Gwynne Raskind wrote: On Apr 25, 2007, at 6:51 PM, Antony Dovgal wrote: I've been plugging around writing extensions long enough to have some idea of the internals; more than once I've answered a question by digging through the Zend sources for the internals

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-05-05 Thread Gwynne Raskind
On Apr 25, 2007, at 6:51 PM, Antony Dovgal wrote: I've been plugging around writing extensions long enough to have some idea of the internals; more than once I've answered a question by digging through the Zend sources for the internals of some API. Great! I'm willing to at least take a

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-26 Thread Stanislav Malyshev
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_. Well, in ICU there are two sets of docs - the automatic docs (e.g.

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-26 Thread Derick Rethans
On Thu, 26 Apr 2007, Marcus Boerger wrote: Hello Antony, Thursday, April 26, 2007, 12:05:07 AM, you wrote: 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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-26 Thread Marcus Boerger
Hello Antony, Thursday, April 26, 2007, 12:25:30 AM, you wrote: On 04/26/2007 02:12 AM, Marcus Boerger 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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-26 Thread Antony Dovgal
On 04/26/2007 09:47 PM, Marcus Boerger wrote: Hello Antony, Thursday, April 26, 2007, 12:25:30 AM, you wrote: On 04/26/2007 02:12 AM, Marcus Boerger 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

[PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Gwynne Raskind
Given the recent discussion of the lack of real documentation for the Zend API, and the endless links provided to various sources of usually incomplete information, I thought it might be a good idea if someone wrote an actual book on the subject. I'm interested in taking that project upon

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Derick Rethans
On Wed, 25 Apr 2007, Gwynne Raskind wrote: Given the recent discussion of the lack of real documentation for the Zend API, and the endless links provided to various sources of usually incomplete information, I thought it might be a good idea if someone wrote an actual book on the subject. I'm

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Gwynne Raskind
On Apr 25, 2007, at 3:33 PM, Derick Rethans wrote: Given the recent discussion of the lack of real documentation for the Zend API, and the endless links provided to various sources of usually incomplete information, I thought it might be a good idea if someone wrote an actual book on the

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Antony Dovgal
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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Marcus Boerger
Hello Antony, Thursday, April 26, 2007, 12:05:07 AM, you wrote: 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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Antony Dovgal
On 04/26/2007 02:12 AM, Marcus Boerger 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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Gwynne Raskind
On Apr 25, 2007, at 6:05 PM, Antony Dovgal 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

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Antony Dovgal
On 04/26/2007 02:32 AM, Gwynne Raskind wrote: I've been plugging around writing extensions long enough to have some idea of the internals; more than once I've answered a question by digging through the Zend sources for the internals of some API. Great! I'm willing to at least take a

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Steph
Subject: Re: [PHP-DEV] Documenting the Zend2 extension API On Apr 25, 2007, at 3:33 PM, Derick Rethans wrote: Given the recent discussion of the lack of real documentation for the Zend API, and the endless links provided to various sources of usually incomplete information, I thought it might

Re: [PHP-DEV] Documenting the Zend2 extension API

2007-04-25 Thread Steph
] Documenting the Zend2 extension API On 04/26/2007 02:32 AM, Gwynne Raskind wrote: I've been plugging around writing extensions long enough to have some idea of the internals; more than once I've answered a question by digging through the Zend sources for the internals of some API. Great! I'm