Re: "waldschrotts guide to nifty references" - manual page draft, version 0.9b

----- Original Message ----- From: André Langhorst <waldschrott@php.net> To: Stanislav Malyshev <stas@zend.com>; PHP Development <php-dev@lists.php.net> 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