Re: Zend API changes

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 hartmut@six.de http://www.six.de +49-711-99091-77