Sorry, guess I need to write a new message instead of replying with a
different subject.
David Coallier wrote:
> The only thing that Alexey asked was if there was some regenerated
> docs. Please, if you feel like you still have problems with SPL in the
> core or any other problems with documentation of extensions because of
> it's documentation, just start another thread. This one should be long
> over, the point was just to ask Marcus to put a new generated version
> online not to start a war on SPL's doxygen's documentation.
>
> Thanks,
> D
I'll start the new thread. ;)
I think the point being that the PHPDOC for SPL is limited is valid.
There are some things that PHPDOC seems to cover better than Doxygen
does and vise versa.
From a PHP developer standpoint, it would be nice if PHPDOC had more
than just "see the Doxygen docs". Doxygen does cover the OO in good
detail, and that is nice. But some things are not explained well enough
like PHPDOC.
So, personally I'd like to see PHPDOC explain what each class/method is
and how to use them. Then have the Doxygen detail the reflection kinds
of stuff for the classes.
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
