Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:36964 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 11418 invoked from network); 11 Apr 2008 18:15:46 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 11 Apr 2008 18:15:46 -0000 Authentication-Results: pb1.pair.com header.from=stas@zend.com; sender-id=pass Authentication-Results: pb1.pair.com smtp.mail=stas@zend.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain zend.com designates 212.25.124.162 as permitted sender) X-PHP-List-Original-Sender: stas@zend.com X-Host-Fingerprint: 212.25.124.162 mail.zend.com Windows 2000 SP4, XP SP1 Received: from [212.25.124.162] ([212.25.124.162:6074] helo=mx1.zend.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id C8/A7-02349-1DAAFF74 for ; Fri, 11 Apr 2008 14:15:46 -0400 Received: from us-ex1.zend.com ([192.168.16.5]) by mx1.zend.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 11 Apr 2008 21:16:23 +0300 Received: from [192.168.16.109] ([192.168.16.109]) by us-ex1.zend.com with Microsoft SMTPSVC(6.0.3790.3959); Fri, 11 Apr 2008 11:16:20 -0700 Message-ID: <47FFAACC.8020001@zend.com> Date: Fri, 11 Apr 2008 11:15:40 -0700 Organization: Zend Technologies User-Agent: Thunderbird 2.0.0.12 (Windows/20080213) MIME-Version: 1.0 To: Philip Olson CC: Etienne Kneuss , David Coallier , Alexey Zakhlestin , PHP internals References: <97A40CDA-69F5-4CD5-8974-276625638380@roshambo.org> In-Reply-To: <97A40CDA-69F5-4CD5-8974-276625638380@roshambo.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-OriginalArrivalTime: 11 Apr 2008 18:16:20.0567 (UTC) FILETIME=[24757670:01C89C00] Subject: Re: [PHP-DEV] spl documentation From: stas@zend.com (Stanislav Malyshev) Hi! > I think all effort should go into writing real documentation within the > phpdoc cvs module instead of unreadable and unofficial doxygen output. I think having core module that is documented by doxygen is a shame. And if there's anybody working on docs, the work should be done first on official docs in the manual, which right now are in the "virtually non-existent" state. Doxygen is a nice thing but no replacement for real documentation. -- Stanislav Malyshev, Zend Software Architect stas@zend.com http://www.zend.com/ (408)253-8829 MSN: stas@zend.com