Hello Nuno,

Tuesday, October 5, 2004, 6:03:13 PM, you wrote:

BTW There aren't so many documentation bugs open... We have made a great
effort to close most of them.
And currently there are more Zend Engine bugs open then documentaion bugs ;)

We still have absolutley no way to document any class. I see this then as the highest priority. And don't tell me i can document methods. What we need is the ability to document hierarchies and methods that are used for more then one class and properties and consts and visibility and and and

regards
marcus

an example of what's needed: http://www.php.net/~helly/php/ext/spl/


Hello Marcus,

Thats true that we don't have good docs for SPL and for iterators.
We have a little introduction at: http://php.net/language.oop5.iterations
And then we have some little docs for SPL: http://php.net/ref.spl

Of course this is critical, as all the other docs are. This is a never ending job (and a hard one!) :)
Please don't kill me just because of my joke. You all do a great work in maintaing and improving PHP, and we try to do the same with the documentation.


We do already have documented some OOP extensions like MySQLi, Tidy or SOAP. They all use different approaches for documenting methods and properties, but we are now trying to figure out which is the best.
If you have some ideas for the docs, please redirect them to me or to the phpdoc list, and will try to add the missing content.



Nuno


--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php



Reply via email to