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.