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

From: Date: Mon, 21 May 2001 13:43:17 +0000
Subject: Re: 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-969335484@lists.php.net to get a copy of this message
From what I gather it will most likely take place in 4.1.x and there will be a switch to turn this on or off. (Probably on by default.) I think this is a great move and will be glad to see it happen. Daniel ----- Original Message ----- From: "Stig Sæther Bakken" <ssb@fast.no> To: "James Moore" <jmoore@php.net> Cc: "'Lars Torben Wilson'" <torben@php.net>; "'Daniel Beckham'" <danbeck@dealnews.com>; "'phpdoc'" <phpdoc@lists.php.net> Sent: Monday, May 21, 2001 4:04 AM Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed case function names > ["James Moore" <jmoore@php.net>] > > > > 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. > > Just a comment from the side here: keep in mind that there has been > discussion on php-dev about making PHP functions and classes case > sensitive in a future release. It won't happen tomorrow, but it's > something to store in ones subconsciousness. > > - Stig > > -- > Stig Sæther Bakken <ssb@fast.no> > Fast Search & Transfer ASA, Trondheim, Norway >

« previous php.doc (#969335484) next »