Re: Function References not showing up in docs for mixed case function names
| From: | Daniel Beckham | Date: | Sun, 20 May 2001 13:55:56 +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-969335451@lists.php.net to get a copy of this message | ||
Hmm.. if you are going to do this in an automated way, you need to look at
<refname></refname> tags also. Those show up on the intro and sidebar nav
areas.
Daniel
----- Original Message -----
From: <jeroen@php.net>
Newsgroups: php.doc
To: <phpdoc@lists.php.net>
Sent: Sunday, May 20, 2001 6:49 AM
Subject: Re: [PHP-DOC] Function References not showing up in docs for mixed
case function names
> > > 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 agree, but for a little consistance it would still be a good idea to
make
> anything lowercase... this can't be too hard,
> just a regular expression to find all <function>...</function>'s, and then
> make it lowercase? Or that script, maybe that works well?
>
> And that even at the start of a sentence. You also don't write numbers in
> uppercase just because they happen to be the first 'word' of a sentence.
>
> In a day or something I'll process the whole documentation (all languages
> too).
>
> Unless someone has any objections of course.
>
> Greetz,
> Jeroen
>
>
>