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 <[EMAIL PROTECTED]>
 http://www.thebuttlesschaps.com
 +1.604.709.0506

Reply via email to