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

From: Date: Sun, 20 May 2001 18:23:48 +0000
Subject: Re: Function References not showing up in docs for mixed case function names
References: 1 2 3 4 5 6  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335453@lists.php.net to get a copy of this message
On Sun, May 20, 2001 at 02:56:31AM -0700, Lars Torben Wilson wrote: > Hojtsy Gabor writes: > > > by Daniel: > > > I would propose that a phpdoc wide change be made so that all functions > > are > > > written in lowercase form. It's not necessary to have them in a mixed > > case > > > created on the author's whim. > > > > > by Jeroen: > > > > > > function-names are NOT case-sensitive in PHP itself... so why not change > > > the stylesheets or something so that it is NOT case-sensitive in the docs > > > either? > > > > > > We've got an excellent DSSSL-fu'er over here :), maybe he or someone > > > else knows how to change that? What do you mean with this? > > XML *IS* case sensitive, and we use XML to make the docs. > > So I think we should be XML compatible with function names too. > > True, but the tool used to document another tool should not define > what is presented to the reader. :) > > I took a quick look through the DSSSL before I committed the patch > which lowercased the Hyperwave <function> tags a couple of days ago, > and it looked as though case-folding was intended, as did the XSL > stylesheet. I haven't had time to look up the syntax used and I'm not > an expert in either though, so I couldn't say for sure and just ended > up running a script over hw.xml to fix the problem. > > To be honest, I've never noticed this problem before, and I've been > working on the manual for 3 years. But then, I always use lowercase > for function names so I wouldn't necessarily have clued in before > now. :) Sorry to reply so late, have been on the road in Germany. This problem with the functions names have been discussed several times. Look at the mysql_*() functions, there is everything ok. Zeev made aliases so we have now easy functions name which can be rememberd by any average user. Sure function names are case-insensitive. But can you imagine to rename a function like ImageCopyMerge() or ImageCopyResampled() to imagecopymerge() or imagecopyresampled()? -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 (#969335453) next »