Re: [PHP-DEV] "waldschrotts guide to nifty references" - manual page draft, version 0.9b From: Sterling Hughes (sterling <email protected>)
Date: 08/19/00

----- Original Message -----
From: André Langhorst <waldschrott <email protected>>
To: Stanislav Malyshev <stas <email protected>>; PHP Development
<php-dev <email protected>>
Sent: Saturday, August 19, 2000 4:16 PM
Subject: Re: [PHP-DEV] "waldschrotts guide to nifty references" - manual
page draft, version 0.9b

> > What for? Refcounting is not visible from userspace in no way, why do
you
> > need it in the manual?
>
> It´s an interesting fact for switchers and experts,
> I don´t think it´s a good idea to hide all technical details,
> we´re open source so why we´re closed technology
>

Want to know about reference counting?

http://www.zend.com/zend/art/ref-count.php

It also contains short coverage of references (aliases).

> > Calling existing PHP manual "few" is a huge underestimate, IMO.
> > But let's not bring there everything and the kitchen sink. Manual should
> > be just reference, not all-about-the-subject tutorial.
>
> You just said. It´s reference ;)
> reference for technical details IMHO, a manual should contain as much
> useful information as possible
>
> like lars says...
>
> > I agree--there are lots of things about the language that don't really
> > need to be explained right in the manual itself. Although an appendix
> > may not be a bad place for this sort of thing, along with the
> > extension programming notes and other things that 99.7% of users won't
> > ever need to know.
>

I agree that it wouldn't hurt to have a note about reference counting in the
PHP manual (ie PHP supports the concept of reference counting), however, I
don't think a full discussion of reference counting would be appropriate in
the manual itself.

-Sterling 

-- 
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: php-dev-unsubscribe <email protected>
For additional commands, e-mail: php-dev-help <email protected>
To contact the list administrators, e-mail: php-list-admin <email protected>