Re: [PHP-DOC] Function References not showing up in docs for mixed case function names From: Daniel Beckham (danbeck <email protected>)
Date: 05/20/01

hehe, the PDF fuctions were the reason I started this thread in the first
place. They should probably all be changed to lowercase sometime after
X-Files is over tonight. =)

Daniel

----- Original Message -----
From: "James Moore" <jmoore <email protected>>
To: "'Lars Torben Wilson'" <torben <email protected>>; "'Daniel Beckham'"
<danbeck <email protected>>
Cc: "'phpdoc'" <phpdoc <email protected>>
Sent: Sunday, May 20, 2001 6:08 PM
Subject: RE: [PHP-DOC] Function References not showing up in docs for mixed
case function names

>
> > > 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.
>
> - James
>
>