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

From: Date: Sun, 20 May 2001 09:56:31 +0000
Subject: Re: Function References not showing up in docs for mixed case function names
References: 1 2 3 4 5  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969335447@lists.php.net to get a copy of this message
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? > > XML *IS* case sensitive, and we use XML to make the docs. > So I think we should be XML compatible with function names too. > > Goba 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. :) -- Torben Wilson <torben@php.net> http://www.thebuttlesschaps.com +1.604.709.0506

« previous php.doc (#969335447) next »