Re: Function References not showing up in docs for mixed case function names

From: 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. :)

« previous php.doc (#969335452) next »