Zeev Suraski wrote:
> Hope is always a good thing :)
> There's a good starting point already, people are more than welcome to
> extend it.

besides all political/philosophical issues (licensing and such ...)

i am talking about a *reference* documentation, not a manual or howto

neither the book chapter you defined to be the official documentation
nor the readme files describe the complete api 

e.g. it's very hard to get the clue what all the *FETCH macros are good
for from the so called official documentation

thats why i talk about a *reference* documentation that explains the 
API funktion by function in manpage style 

i've been into all this for more than a year now and i still have 
lots of open questions about a lot of things even after doing a *lot*
of "Read the source, Luke" and this is, well, lets say 'suboptimal'

for stuff as complex (and as stuffed with preprocessor magic) like
the Zend Engine it is usually a very bad idea to have people write
the docs for it that didn't build it

thats like playing "Stille Post" (afaik this game is called "telephone"
in the US) or like babelfish translating a text from one language to
another and back: very funny results but not very helpfull

don't get me wrong, the Engine is a very impressive piece of work
(although i do not really like the license, but i can live with it)
but with reference documentation that deserves this name it would
still be far better.

PS: about the "welcome" thing above ...

-  you should know that i have put a lot of work into the manual
   (both english and german) and the function tables

-  afair there was someone who started to write a 'extension 
   building manual' or something about a year ago and it was you
   , Zeev, who told him that this was useless effort as this was 
   already beeing taken care off (without pointing him to this
   project or inviting him to join it)
   correct me if i'm wrong as i do not have found this posting
   in my archives yet

Hartmut Holzgraefe  [EMAIL PROTECTED]  http://www.six.de  +49-711-99091-77

PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]

Reply via email to