Re: Function References not showing up in docs for mixed case function names
| From: | Daniel Beckham | Date: | Sun, 20 May 2001 14:00:19 +0000 |
| Subject: | Re: Function References not showing up in docs for mixed case function names | ||
| References: | 1 2 3 4 5 6 7 8 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969335452@lists.php.net to get a copy of this message | ||
As far as English grammar goes, they should be capitalized if they are the
first word in a sentence. If you are using the function name as the first
word though, you probably could come up with a better way to write it.
bad: Foo() does bar;
good: The function foo() does bar.
Daniel
----- Original Message -----
From: "Lars Torben Wilson" <torben@php.net>
Newsgroups: php.doc
To: <jeroen@php.net>
Cc: <phpdoc@lists.php.net>
Sent: Sunday, May 20, 2001 7:09 AM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> > And that even at the start of a sentence. You also don't write numbers
in
> > uppercase just because they happen to be the first 'word' of a sentence.
>
> Bad example: sentences shouldn't start with digits anyway. Spell the
> word out at the start of a sentence. It remains largely undecided as
> to whether function names should be capitalized when starting a
> sentence--I personally believe they should not be, but not everybody
> thinks that way. :)