Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:29347
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain roshambo.org from 207.210.105.50 cause and error)
In-Reply-To: <8F6E78F4-9B53-43FA-8E7E-3460800F9AAD@wanderingknights.org>
References: <97180F0D-CB4C-4071-A859-38059C0DD1FF@wanderingknights.org> <Pine.LNX.4.62.0704252131190.1454@localhost> <0DFF3A59-3419-4A25-B907-E0E71FD41360@wanderingknights.org> <462FD093.90402@zend.com> <C74FB334-3BAF-4324-A439-235723F2EB3A@wanderingknights.org> <462FDB7B.8000907@zend.com> <8F6E78F4-9B53-43FA-8E7E-3460800F9AAD@wanderingknights.org>
Mime-Version: 1.0 (Apple Message framework v752.3)
Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed
Message-ID: <4850AC0C-7268-4CE2-A192-771F459A2CB5@roshambo.org>
Cc: internals@lists.php.net
Content-Transfer-Encoding: 7bit
Date: Tue, 8 May 2007 11:59:18 -0700
To: Gwynne Raskind <gwynne@wanderingknights.org>
Subject: Re: [PHP-DEV] Documenting the Zend2 extension API
From: philip@roshambo.org (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  
>>> of some API.
>> Great!
>>> I'm  willing to at least take a crack at this project; the worst  
>>> I can do  is fail :). Would it make sense to ask for CVS karma on  
>>> the docs now  or wait a bit?
>> I believe the best way to get karma is to start sending patches.
>>
>> I would also recommend to establish the build environment for the  
>> docs (if you don't have one already), it's good idea to test  
>> patches before committing.
>> This document should give you a good start: http://doc.php.net/php/ 
>> dochowto/index.php
>
> 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 all the advice so far!

Hello Gwynne,

This is excellent news, and feel free to write the doc list if you  
have any questions and/or the IRC channels on efnet (#php.pecl and  
#php.doc). As far as information on the topic goes, let's start a  
list of the current landscape (with ideas to steal from):

- The official docs: http://php.net/manual/internals
- CodeGen_PECL: http://pear.php.net/package/codegen_pecl
- A few tutorials: http://devzone.zend.com/public/view/tag/extension
- The book: Extending and Embedding PHP by Sara Golemon
- Many README files in php-src: http://cvs.php.net/viewvc.cgi/php-src/
- A few talks: http://talks.php.net/index.php/Internals
- A nice talk: http://netevil.org/talks/furlong-golemon-extending- 
php.pdf
- More talks: http://talks.somabo.de/
- A nice talk: http://talks.somabo.de/ 
200610_zend_conf_php_extension_development.pdf
- A few examples: http://people.apache.org/~nabeel/php/examples/

Also, let's create a FAQ section dedicated to the topic of extension  
writing.

Regards,
Philip