Hi Ryan, I forwarded your message to php.doc -------- Original Message -------- Subject: PHPDOC and SPL Documentation Date: Fri, 11 Apr 2008 14:35:47 -0500 From: [EMAIL PROTECTED] (Ryan Panning) To: [EMAIL PROTECTED] Newsgroups: php.internals
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. -- Edward Z. Yang GnuPG: 0x869C48DA HTML Purifier <http://htmlpurifier.org> Anti-XSS Filter [[ 3FA8 E9A9 7385 B691 A6FC B3CB A933 BE7D 869C 48DA ]]
