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

From: Date: Sun, 20 May 2001 20:31:18 +0000
Subject: Re: Function References not showing up in docs for mixed case function names
References: 1 2 3 4 5 6 7  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335458@lists.php.net to get a copy of this message
eschmid+sic@s.netic.de writes: > > 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. Yup--but here I think we were specifically referring to the case used in <function> tags in the manual. But the Great Renaming Debate has certainly been gone over a few times this year. :) > Sure function names are case-insensitive. But can you imagine to rename a > function like ImageCopyMerge() or ImageCopyResampled() to imagecopymerge() > or imagecopyresampled()? Yup, if only because it calls attention to the fact that the function could have been named more carefully in the first place :) Besides, like I said, I'm not as interested in the actual case of the function names in the manual as I am in getting the hyperlinks working: that's the most important thing from the reader's point of view IMHO. > -Egon -- Torben Wilson <torben@php.net> http://www.thebuttlesschaps.com +1.604.709.0506

« previous php.doc (#969335458) next »