Re: Function References not showing up in docs for mixed case function names
| From: | Daniel Beckham | Date: | Mon, 21 May 2001 13:43:17 +0000 |
| Subject: | Re: Function References not showing up in docs for mixed case function names | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969335484@lists.php.net to get a copy of this message | ||
From what I gather it will most likely take place in 4.1.x and there will be
a switch to turn this on or off. (Probably on by default.) I think this is
a great move and will be glad to see it happen.
Daniel
----- Original Message -----
From: "Stig Sæther Bakken" <ssb@fast.no>
To: "James Moore" <jmoore@php.net>
Cc: "'Lars Torben Wilson'" <torben@php.net>; "'Daniel
Beckham'"
<danbeck@dealnews.com>; "'phpdoc'" <phpdoc@lists.php.net>
Sent: Monday, May 21, 2001 4:04 AM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> ["James Moore" <jmoore@php.net>]
> > > > bad: Foo() does bar;
> > > > good: The function foo() does bar.
> > > >
> > > > Daniel
> > >
> > > I agree with your second assertion. I could see a lot of
> > > users getting confused if the first were followed blindly,
> > > though (say, if one was documenting C). Which is one reason
> > > (besides style) why I agree with the second assertion...:)
> >
> > Im sorry but I feel we should keep all function names lowercase. Take a
> > look at http://php.net/manual/en/ref.pdf.php now, that
> > really looks ugly
> > too me, there is no reason to have function names at beginning of
> > sentences and lets keep the manual consistent, if its all lowercase we
> > will encourage people to name their functions properly etc, we are not
> > going to start putting PdF_OpeN in the manual just because its supported
> > lets keep the manual consistent and keep it lowercase, this has worked
> > for the past x years and there is no real reason to change it.
>
> Just a comment from the side here: keep in mind that there has been
> discussion on php-dev about making PHP functions and classes case
> sensitive in a future release. It won't happen tomorrow, but it's
> something to store in ones subconsciousness.
>
> - Stig
>
> --
> Stig Sæther Bakken <ssb@fast.no>
> Fast Search & Transfer ASA, Trondheim, Norway
>