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

From: Date: Sun, 20 May 2001 23:07:19 +0000
Subject: RE: [PHP-DOC] Function References not showing up in docs for mixed case function names
References: 1 2  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335468@lists.php.net to get a copy of this message
James Moore writes: > > > > 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 +1 -- Torben Wilson <torben@php.net> http://www.thebuttlesschaps.com +1.604.709.0506

« previous php.doc (#969335468) next »