Date: 05/20/01
- Next message: eschmid+sic <email protected>: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Previous message: Daniel Beckham: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- In reply to: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Next in thread: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Reply: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
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 <email protected>>
Newsgroups: php.doc
To: <jeroen <email protected>>
Cc: <phpdoc <email protected>>
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. :)
- Next message: eschmid+sic <email protected>: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Previous message: Daniel Beckham: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- In reply to: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Next in thread: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Reply: Lars Torben Wilson: "Re: [PHP-DOC] Function References not showing up in docs for mixed case function names"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

