Btw, the book Derick, Stig and I wrote ("PHP 5 Power Programming") also
has a chapter re: writing extensions. While it covers only a subset and
has not been updated, I think it does a good job in explaining some of
the fundamentals.
Reason why I bring this up is because the book is under the open
publication license and I believe it might allow you to steal some
pieces for the PHP manual. I can get you the exact license if you need
(it's been a while so I don't remember exactly which clauses we chose
but I think it can be used).
Andi
> -----Original Message-----
> From: Philip Olson [mailto:[EMAIL PROTECTED]
> Sent: Friday, June 01, 2007 9:31 PM
> To: Gwynne Raskind
> Cc: [email protected]
> Subject: Re: [PHP-DEV] Documenting the Zend2 extension API
>
> >
> > <part id="internals2">
> > <title>&Internals2;</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 -->
> > &internals2.memory.index; <!-- management,
> persistence, TSRM -->
> > &internals2.variables.index; <!-- zval, hashtable, references,
> > constants -->
> > &internals2.functions.index; <!-- defining, arguments, return
> > values, passthru, aliasing -->
> > &internals2.objects.index; <!-- classes, inheritance,
> > properties, methods, method-function mapping -->
> > &internals2.resources.index; <!-- defining, creating,
> retrieving,
> > destroying -->
> > &internals2.ini.index; <!-- defining, retrieving,
> changing
> > -->
> > &internals2.streams.index; <!-- using, wrappers, contexts,
> > filters -->
> > <!-- grab the PDO section from &Internals; here? -->
> > &internals2.apiref.index; <!-- full index of all APIs,
> > constants, macros, etc. -->
> > &internals2.ze1.index; <!-- quick list of major
> > differences, short discussion re: OOP -->
> > &internals2.ze3.index; <!-- quick discussion of major
> > changes, some details on Unicode -->
> > </part>
> >
> > My thinking is to document ZE2 completely, since the differences
> > between 1 and 2 are small enough for the existing internals
> section to
> > be of use to anyone writing for 1, and 3 can be more fully
> documented
> > later (something I'm willing to take on as well).
> >
> > If I'm given a thumbs-down on this way of doing things,
> I'll take the
> > material I've written already and use it to update the existing
> > internals section, but I think this method has the best chance of
> > giving people the truly comprehensive online reference we've lacked
> > for extension writing up to this point.
>
> Hello Gwynne,
>
> Sounds good. Many times silence on this list means "Sounds
> good" and internals isn't too keen on defining a structure
> for documentation... :) So, go for it! Always feel free to
> ask questions while documenting this and as it all progresses
> let's be sure internals reviews the information too. Once the
> information is in manageable and smaller pieces you'll likely
> have more success getting feedback. And don't be a stranger
> on #php.pecl @ efnet (IRC) either.
>
> Regards,
> Philip
>
> --
> PHP Internals - PHP Runtime Development Mailing List To
> unsubscribe, visit: http://www.php.net/unsub.php
>
>
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
