Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:36962
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.146.183 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
        b=YuEvc6rz+o0G6oJ77cHlSccH81I2pGgB3wErTWqyP6OhYjhq4z03qeuvVQCLveAkL3uM1xfy6hPYSwv/Qwb02GJsU8oKWQR6ZrTWgT4rFmY19Y1qNIyr820HEl8AkWKh6GK4qBzjhH56BJ2Pthpmc2yMFUqVJxnYXU7jjbM1zlM=
Message-ID: <b5f7bf6c0804111046kf81c761w13bb7aea614338b8@mail.gmail.com>
Date: Fri, 11 Apr 2008 13:46:00 -0400
Sender: david.coallier@gmail.com
To: "Philip Olson" <philip@roshambo.org>
Cc: "Etienne Kneuss" <colder@php.net>, "Alexey Zakhlestin" <indeyets@gmail.com>, 
	"PHP internals" <internals@lists.php.net>
In-Reply-To: <97A40CDA-69F5-4CD5-8974-276625638380@roshambo.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <cd5680a20804110816o94cf3d6sd365160ba262ffc9@mail.gmail.com>
	 <b5f7bf6c0804110842l256b8687yb183980e715ef549@mail.gmail.com>
	 <e666c3890804110955i7616b8d3ref5c53349d45e8e8@mail.gmail.com>
	 <97A40CDA-69F5-4CD5-8974-276625638380@roshambo.org>
Subject: Re: [PHP-DEV] spl documentation
From: davidc@php.net ("David Coallier")

>
>  I think all effort should go into writing real documentation within the
> phpdoc cvs module instead of unreadable and unofficial doxygen output.
> Personally I feel the link to the doxygen output should be removed from
> php.net/spl (but won't) so anyway those are my feelings. Etienne is planning
> to work on both, which is great, but I encourage everyone to update the
> official spl documentation and not worry much about doxygen.
>

I agree with you on the part that efforts should be put for the phpdoc
but I personally consider doxygen's output to be much more complete
than any phpdoc output.

The doxygen output is very technical and usually if you are looking
for something very specific, you'll find it. PHPDocs and Doxygen
outputs are really 2 separate beasts, for instance with Doxygen you'll
see a clear hierarchy between the objects/classes and which classes
they inherit and implement whereas the phpdoc will describe the
functions clearly. There are many things that doxygen does that phpdoc
doesn't do and the same for phpdoc and doxygen.

Anyways, I think we still need that doxygen output and it would be
plain bad to scrap it.

D