Re: MySQL examples need review
| From: | Jan Lehnardt | Date: | Sun, 23 Dec 2001 19:12:17 +0000 |
| Subject: | Re: MySQL examples need review | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 12 13 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969340310@lists.php.net to get a copy of this message | ||
Hi,
On Sun, 23 Dec 2001 18:43:50 -0000
"James Moore" <jmoore@php.net> wrote:
>
>
> > > What do others think about that?
> > I give a +1 for adapting the PEAR coding standard for Manual
examples.
>
> -1 for anything complicated in the manual. Keep everything clear and
concise
> why do we need to clutter examples with PEAR error everywhere (Nothing
> against pear I think its great but I dont think its all that clear for
> examples in a manual.) Most code out there isnt written with PEAR at
all and
> thus when comparing code and the manual it might be unclear to the
reader.
to quote myself:
" At first PEAR does have a excellent
error handling, but it is to complex to intoduce it inside of examples
in the PHP manual. Nevertheless error handling is needed. I vote for the
'or die()' construct where needed (e.g. mysql_connect() and friends)"
I said nothing about using PEAR itself in the manual examples. I am
against it either. I just want to adapt the PEAR coding standart to the
manual.
Jan
--
Q: Thank Jan? A: http://geschenke.an.dasmoped.net/