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: <[EMAIL PROTECTED]>
To: <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>
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, [EMAIL PROTECTED] 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/
>
