Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:24058 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 68804 invoked by uid 1010); 9 Jun 2006 21:52:34 -0000 Delivered-To: ezmlm-scan-internals@lists.php.net Delivered-To: ezmlm-internals@lists.php.net Received: (qmail 68789 invoked from network); 9 Jun 2006 21:52:34 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 9 Jun 2006 21:52:34 -0000 X-PHP-List-Original-Sender: lsmith@php.net X-Host-Fingerprint: 212.112.227.169 ipx11223.ipxserver.de Linux 2.5 (sometimes 2.4) (4) Received: from ([212.112.227.169:54340] helo=ipx11223.ipxserver.de) by pb1.pair.com (ecelerity 2.0 beta r(6323M)) with SMTP id 3C/4A-30619-1ADE9844 for ; Fri, 09 Jun 2006 17:52:34 -0400 Received: from localhost (localhost [127.0.0.1]) by ipx11223.ipxserver.de (Postfix) with ESMTP id 920FBDF0047; Fri, 9 Jun 2006 23:53:44 +0200 (CEST) Received: from ipx11223.ipxserver.de ([127.0.0.1]) by localhost (ipx11223 [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 16406-04; Fri, 9 Jun 2006 23:53:36 +0200 (CEST) Received: from [127.0.0.1] (i577B5B6A.versanet.de [87.123.91.106]) by ipx11223.ipxserver.de (Postfix) with ESMTP id 79D44DF0007; Fri, 9 Jun 2006 23:53:35 +0200 (CEST) Message-ID: <4489ED8D.9090000@php.net> Date: Fri, 09 Jun 2006 23:52:13 +0200 User-Agent: Thunderbird 1.5.0.4 (Windows/20060516) MIME-Version: 1.0 To: Andi Gutmans Cc: Steph Fox , Nuno Lopes , Andrei Zmievski , helly@php.net, Derick Rethans , internals@lists.php.net References: <7.0.1.0.2.20060608162444.06db8390@zend.com> <7.0.1.0.2.20060609065445.0371fe28@zend.com> <35340f912d5d4405f2da5183d804f165@gravitonic.com> <008d01c68bfe$1bc02890$0100a8c0@pc07653> <17e201c68c01$4c0d8c10$6602a8c0@foxbox> <7.0.1.0.2.20060609132442.03b41010@zend.com> In-Reply-To: <7.0.1.0.2.20060609132442.03b41010@zend.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Scanned: by somedaemon at backendmedia.com Subject: Re: [PHP-DEV] SPL docs From: lsmith@php.net (Lukas Smith) Andi Gutmans wrote: > Hey, > > I'm obviously not an expert on this stuff so I don't have much added > value to add. However, I think from a high-level I think it's important > that we have one PHP manual and that the manual covers both functional > and oo extensions. I think the last thing we want is to have several PHP > manuals. > My $.02. Now I'll shut up :) Well PEAR is far from being able to claim that it has solved its documentation problems. However I generally think that its ok to have different tools for API documentation and end user "tutorial" style documentation. However I guess the main stumbling block is that the PEAR API documentation is currently generated directly from the source which does not really lend itself well for translations. It also means that we have documentation for every single version ever released. However at least I have not been good about noting when features have been added. Also doxygen produces much nicer inheritance graphs than what we currently have. regards, Lukas