Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:36966 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 21943 invoked from network); 11 Apr 2008 19:09:36 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 11 Apr 2008 19:09:36 -0000 X-Host-Fingerprint: 64.8.134.189 unknown Received: from [64.8.134.189] ([64.8.134.189:24885] helo=localhost.localdomain) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 25/79-02349-F67BFF74 for ; Fri, 11 Apr 2008 15:09:35 -0400 Message-ID: <25.79.02349.F67BFF74@pb1.pair.com> To: internals@lists.php.net Date: Fri, 11 Apr 2008 14:09:33 -0500 User-Agent: Thunderbird 2.0.0.12 (Windows/20080213) MIME-Version: 1.0 References: <97A40CDA-69F5-4CD5-8974-276625638380@roshambo.org> <47FFAACC.8020001@zend.com> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Posted-By: 64.8.134.189 Subject: PHPDOC and SPL Documentation From: rpanning@gmail.com (Ryan Panning) 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.