Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:24070
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
	s=beta; d=gmail.com;
	h=received:message-id:date:from:to:subject:in-reply-to:mime-version:content-type:references;
	b=V9K/9iq0G1pKyC0mCrqAgcEuaDW+g/dOuxzMKL9DnMVg99HpYz0sTve+jWwv5H9wWgJ74IbalIIjkMkdQntKxQFqYps7xNiZKz/vgHTwu7YspDKWDNL+AbqQPL/KfaFj28gCijS/2S//Y17iVLkbdLXy4jQsgnZaRZL3Y2qDwt0=
Message-ID: <1944df00606091847l213857a5x497b88aaf70320a3@mail.gmail.com>
Date: Sat, 10 Jun 2006 11:47:39 +1000
To: internals@lists.php.net
In-Reply-To: <448A0AE8.1080509@lerdorf.com>
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_Part_10958_13919095.1149904059893"
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>
	<448A0AE8.1080509@lerdorf.com>
Subject: Re: [PHP-DEV] SPL docs
From: shiznatz@gmail.com ("Robert Amos")

------=_Part_10958_13919095.1149904059893
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

I agree with Rasmus here, there should be at least some level of the docs in
the PHP manual. Its always been considered the "one stop shop" for reference
for all the beginning coders that I've seen, and is one of the draws for the
language.

Having a seperate set of docs for the more "advanced" information about SPL
is fine too.

-bok

On 6/10/06, Rasmus Lerdorf <rasmus@lerdorf.com> wrote:
>
> I find the Doxygen-generated SPL docs maze-like and pretty much
> impossible to navigate.  There is nothing stopping you from maintaining
> that separate document, but I'd love to see the useful bits integrated
> into the PHP docs.  Losing the inheritance graphs doesn't bother me a bit.
>
> -Rasmus
>
> Marcus Boerger wrote:
> > Hello Andi,
> >
> >   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.
> >
> > best regards
> > marcus
> >
> > Friday, June 9, 2006, 3:57:12 PM, you wrote:
> >
> >> This is a docbook limitation? Couldn't we still find some standard
> >> way to write it? most of it is manual stuff ala
> >> http://framework.zend.com/manual/en/zend.html?
> >> No?
> >> Andi
> >
> >
> >> At 12:24 AM 6/9/2006, Marcus Boerger wrote:
> >>> Hello Andi,
> >>>
> >>>   the problem is the non existing OO support in docbook. I had the
> idea
> >>> of eventually using doxygen's xml output and putting that somehow in
> the
> >>> manual. But that's is probably something for livedocs. So lets have
> >>> livedocs first. Apart from that nobody hinders the doc team from
> copying
> >>> and translating the stuff from the separate SPL docs to the manual. It
> is
> >>> just impossible to integrate the inheritance info and all the graphics
> to
> >>> the manual.
> >>>
> >>> best regards
> >>> marcus
> >>>
> >>>
> >>> Friday, June 9, 2006, 1:25:56 AM, you wrote:
> >>>
> >>>> Hey Marcus,
> >>>> Any chance we can get the SPL docs integrated into the PHP manual? I
> >>>> get questions about it here and there and think that as it's in the
> >>>> default PHP distro it makes sense to have that as part of the
> >>>> official PHP manual.
> >>>> Andi
> >>>
> >>>
> >>>
> >>> Best regards,
> >>>  Marcus
> >
> >
> >
> >
> > Best regards,
> >  Marcus
> >
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>


-- 
Xnyo - http://xnyo.odynia.org/

------=_Part_10958_13919095.1149904059893--