PHPDOC and SPL Documentation
| From: | Ryan Panning | Date: | Fri, 11 Apr 2008 19:09:33 +0000 |
| Subject: | PHPDOC and SPL Documentation | ||
| References: | 1 2 3 4 5 6 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-36966@lists.php.net to get a copy of this message | ||
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, DI'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.