Documenting ZE (was: Re: [PHP-DEV] zend_parse_parameters)

On Sun, 9 Sep 2001, Zeev Suraski wrote: >At 14:44 09-09-01, Jani Taskinen wrote: > >>"..People don't read the .h files usually and copy from other extensions.." >> >>If ZE was properly documented, people didn't have to rely on >>only the sources. >> >>Like I suggested earlier, by adding at least protos there >>would help the documentation effort..ie. START it. > >Go ahead, you're welcome to do that. Seriously Jani, stop bugging us with >requests to do things. It's still an opensource project and we, like >anybody else, work on what we feel like working. I don't think I have really 'bugged' you about it so far. I promise to do that from now on. :) What I meant with this was that to even start the documentation effort, there should be some basic information for the functions defined in ZE. example: /* {{{ proto int zend_register_module(zend_module_entry *module_entry) Register an extension and functions it provides in the module_registry and function_table hashes. */ We should first agree that this is a good idea before anybody adds anything anywhere. And I don't want to be the only one doing this. :) And that should be also agree on that everything new added will have these protos. Maybe start this with ZE2 ? >By the way, your post had absolutely nothing to do with the subject of the >discussion. I forgot to add: "This is off-topic"...so? --Jani