Re: Casing function names: Conclusion = ?

From: Date: Wed, 23 May 2001 02:13:18 +0000
Subject: Re: Casing function names: Conclusion = ?
References: 1 2 3 4 5 6 7 8 9 10  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335518@lists.php.net to get a copy of this message
I would normally say yes to lowercasing all function names, (and I argued for it last week) but I have to agree with Egon here. I think that making all function names lowercase will limit the readability of certain function libraries. The most obvious example is the Image functions. I think we need to create more readable function aliases and then re-document those instead. In the end, we are producing a document for the PHP public and making it diffcult for them to read function names here in the docs and in their code is a bit of a disservice. Just as much as not having function names hyperlinked. IMHO Daniel ----- Original Message ----- From: <eschmid+sic@s.netic.de> To: <jeroen@php.net>; <phpdoc@lists.php.net> Sent: Tuesday, May 22, 2001 7:16 PM Subject: Re: [PHP-DOC] Casing function names: Conclusion = ? > On Wed, May 23, 2001 at 01:27:18AM +0200, jeroen@php.net wrote: > > > All function names in the docs should be lowercase for consistence. No > > matter where in the sentence, or how unreadable the function will be. > > I'm against this. It would result in unreadable and bad to > remember function names. > > > For unreadable func-names, a longer-term renaming would be nice. But > > first, get the manual lowercase. Then those php.dev guys will just need > > to rename, because we are NOT going to write it mixed case anymore > > for readability. > > I would recommend to make aliases in the source code first. After that we > should the change the function names in the manuals. > > > Just only react if you strongly disagree. If nobody strongly disagrees, > > I'll commit the changes somewhere in the next week. Thanks to Torben's > > script, and including the <refentry> stuff etc. > > I have nothing against Torben, he has also read about my fight with some > core developers and now the mysql_*() functions are more readable. You can > also use the old syntax. The original functions havent been removed yet. > > -Egon > > -- > LinuxTag, Stuttgart, Germany: July 5-8 2001: > http://www.linuxtag.de/ > All known books about PHP and related books: > http://php.net/books.php > Concert Band of the University of Hohenheim: > http://www.concert-band.de/ > First and second bestselling book in German: > http://www.php-buch.de/ >

« previous php.doc (#969335518) next »