RE: [PHP-DOC] Function References not showing up in docs for mixed case function names

From: Date: Sun, 20 May 2001 23:08:35 +0000
Subject: RE: [PHP-DOC] Function References not showing up in docs for mixed case function names
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335467@lists.php.net to get a copy of this message
> > 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

« previous php.doc (#969335467) next »