Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:24061 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 88186 invoked by uid 1010); 9 Jun 2006 22:21:47 -0000 Delivered-To: ezmlm-scan-internals@lists.php.net Delivered-To: ezmlm-internals@lists.php.net Received: (qmail 88171 invoked from network); 9 Jun 2006 22:21:47 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 9 Jun 2006 22:21:47 -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:55244] helo=ipx11223.ipxserver.de) by pb1.pair.com (ecelerity 2.0 beta r(6323M)) with SMTP id 10/5D-30619-B74F9844 for ; Fri, 09 Jun 2006 18:21:47 -0400 Received: from localhost (localhost [127.0.0.1]) by ipx11223.ipxserver.de (Postfix) with ESMTP id 659A4DF0007; Sat, 10 Jun 2006 00:22:58 +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 16039-07; Sat, 10 Jun 2006 00:22:50 +0200 (CEST) Received: from [127.0.0.1] (i577B5B6A.versanet.de [87.123.91.106]) by ipx11223.ipxserver.de (Postfix) with ESMTP id 60C07DF0047; Sat, 10 Jun 2006 00:22:49 +0200 (CEST) Message-ID: <4489F46A.6060601@php.net> Date: Sat, 10 Jun 2006 00:21:30 +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> <4489ED8D.9090000@php.net> <7.0.1.0.2.20060609151753.03a710e0@zend.com> In-Reply-To: <7.0.1.0.2.20060609151753.03a710e0@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: > Yeah API docs is useful, but still we should have the end-user docs in > the PHP manual. I don't think once comes instead of the other. The > end-user docs is especially useful as people in the community can give > comments, etc... Err, you misunderstood what I was trying to say. All I was saying that we are generating API docs automatically from the phpdoc comments and providing end user docs separately (which gets translated) written in docbook that can of course link to the API docs. regards, Lukas