Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:24074
Return-Path: <helly@php.net>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 25451 invoked by uid 1010); 10 Jun 2006 11:22:04 -0000
Delivered-To: ezmlm-scan-internals@lists.php.net
Delivered-To: ezmlm-internals@lists.php.net
Received: (qmail 25436 invoked from network); 10 Jun 2006 11:22:04 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 10 Jun 2006 11:22:04 -0000
X-PHP-List-Original-Sender: helly@php.net
X-Host-Fingerprint: 81.169.182.136 ajaxatwork.net Linux 2.4/2.6
Received: from ([81.169.182.136:49796] helo=strato.aixcept.de)
	by pb1.pair.com (ecelerity 2.0 beta r(6323M)) with SMTP
	id 25/22-30619-B5BAA844 for <internals@lists.php.net>; Sat, 10 Jun 2006 07:22:03 -0400
Received: from baumbart.mbo (dslb-084-063-027-200.pools.arcor-ip.net [84.63.27.200])
	(using TLSv1 with cipher AES256-SHA (256/256 bits))
	(No client certificate requested)
	by strato.aixcept.de (Postfix) with ESMTP id 8A6A235C1C1;
	Sat, 10 Jun 2006 13:22:00 +0200 (CEST)
Date: Sat, 10 Jun 2006 13:22:15 +0200
Reply-To: Marcus Boerger <helly@php.net>
X-Priority: 3 (Normal)
Message-ID: <2410680692.20060610132215@marcus-boerger.de>
To: Steph Fox <steph@zend.com>
Cc: Andi Gutmans <andi@zend.com>, internals@lists.php.net
In-Reply-To: <186701c68c7c$cffa7990$6602a8c0@foxbox>
References: <7.0.1.0.2.20060608162444.06db8390@zend.com> <1934915062.20060609092414@marcus-boerger.de> <7.0.1.0.2.20060609065558.037ca148@zend.com> <673041320.20060610015205@marcus-boerger.de> <186701c68c7c$cffa7990$6602a8c0@foxbox>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] SPL docs
From: helly@php.net (Marcus Boerger)

Hello Steph,

Saturday, June 10, 2006, 12:58:30 PM, you wrote:

> Hi Marcus

>>  that's nothing more than our manual besides a different layout. I'd
>> like to document how studd is being integrated, how stuff works together
>> and how inheritance trees look like. You saw the gtk tree, wow, cool if
>> there is only one real tree like inheritance graph. But unfortunatley
>> SPL has a great amount of interfaces floating around. Intrgrating that
>> and hving all that information revealed is a great problem. I use the
>> docu myself so maybe i am looking from another level but i am not
>> willing to give that level away. I'd rather change the toolset, only the
>> toolchain i can change is doxygen.

> Yep, we're about to hit similar issues over documenting interfaces in 
> PHP-GTK...  at present they're more or less treated as classes. I really 
> don't want to throw away the entire php-gtk-doc structure just to deal with 
> those though :) and I'd imagine nobody wants to throw out the otherwise 
> solid phpdoc structure either.

> I have to say also that I don't find doxygen-generated documentation 
> intuitive. It's more useful if you already know about something and need to 
> look up some detail than it is if you're trying to learn how that thing 
> works in the first place.

Both true, still tht what i use docs most for, looking up stuff again to
be really sure.

Best regards,
 Marcus