On 2001-30-12 05:53, Gabor Hojtsy wrote: > > Ah, and btw, that's what we've the documentation team for, no? > > Well, no php-dev people is engaged to know DocBook XML, the > doc building process, or translation related things. No phpdoc people > engaged to know C, some know very few C, or have no experience > with C at all. > > I have seen a note in the php-weekly sometime ago from Rasmus, > bringing the fact to attention, that all people who have write Karma > to the "php4" module, have write Karma to the "phpdoc" module. This > needs to be for something :) Maybe just to give a possibility for a > dream to come true :) IMHO only a few poeple have > write Karma to "php4" from "phpdoc". I do not say, that to document > any extension or function, we need write Karma. This only shows, that > the majority of documentation people are not involved in development. > > I took part in Sterlings whole day workshop and Zak's intro to the > PHP source session at the php conference. I cannot say I understand > what's in the C code know, but I have a better understanding. Using > that knowledge, I was able to write documentation for things like > ini_file(), > and some functions like this. As you know, to understand the PHP C > source, knowing C is not enough. One even need to know the Zend > API. For the Zend API, we have a somewhat oudated documentation, > from the early days, when the PHP 4 version was not even released. [...]
There is a wiki to support my talk from the PHP I18N Conference that is located at http://fooassociates.com/rtfs It contains the complete text (more *and* less :) of my presentation. The PHPDoc team may find it handy. Also, if you ask questions on the Wiki about particular aspects of the source, I will do my best to answer them (or find someone who can). --zak -- 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]
