Re: cvs: phpdoc /en/reference/strings/functions implode.xml
| From: | Derick Rethans | Date: | Fri, 06 Jun 2003 21:17:57 +0000 |
| Subject: | Re: cvs: phpdoc /en/reference/strings/functions implode.xml | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969354313@lists.php.net to get a copy of this message | ||
On Fri, 6 Jun 2003, John Coggeshall wrote:
> On Fri, 2003-06-06 at 15:33, Jani Taskinen wrote:
> >
> > Just document the preferred way to use any function.
> > Like in this case, the correct way is to use all parameters:
> >
> > string implode (string glue, array pieces)
>
> If the documentation points out more than one syntax, I consider it
> confusing to not provide that optional syntax as one of the prototypes.
As Jani said, the *correct* way to use it is with both parameters,
document it as such. This is called 'education', something we do for
*our* users.
Derick
--
"my other box is your windows PC"
-------------------------------------------------------------------------
Derick Rethans http://derickrethans.nl/
International PHP Magazine http://php-mag.net/
-------------------------------------------------------------------------