Re: a few coding standards
| From: | Aidan Lister | Date: | Fri, 30 Jul 2004 02:54:03 +0000 |
| Subject: | Re: a few coding standards | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969362370@lists.php.net to get a copy of this message | ||
Hey Philip,
I also run a livedocs server,
http://livedocs.homelinux.com/
I'll be setting one up on the dotgeek server soon, (hopefully).
"Philip Olson" <philip@cornado.com> wrote in message
news:Pine.BSF.4.10.10407281617570.35827-100000@merlin.pegasi.net...
> > > Personally I think
> > >
> > > http://www.php.net/manual/en/function.mysqli-close.php is one of the
> > > most confusing manual pages I have seen to date,
> > > http://www.php.net/manual/en/class.dir.php is also
> > > high on that list
> > >
> > > Indentation of pseudo-objects would help a great deal.
> >
> > The dsssl cheets aren't well costumised (if they are) for <ooclass>.
> > Livedocs doesn't deal with OO yet.
> >
> > > Anyway, mysqli-close is confusing :)
> >
> > MySQLi docs are a bit confusing... consider the mysqli close:
> >
> > mysqli_close
> > (PHP 5)
> > mysqli_close
> > (no version information, might be only in CVS)
> > mysqli->close -- Closes a previously opened database connection
> > Description
>
> I don't know where we're at on this OOP generation stuff but it's
> not something I know much about. Procedural all the way baby! But
> seriously I believe people are working on it or at least it's a
> known issue but really DSSSL has cob webs and I doubt that will
> change (unless you are somebody you knows has a large broom).
>
> Here's how livedocs outputs it, looks a bit better huh? Not sure
> what version of livedocs this is (or how old these docs are) but
> it's the only online livedocs I could find:
>
> http://livedocs.coggeshall.org/en/function.mysqli-close.html
>
> The dir class also looks a lot better here:
>
> http://livedocs.coggeshall.org/en/class.dir.html
>
> Regards,
> Philip