Re: Proposal: CHANGELOG
| From: | Philip Olson | Date: | Mon, 16 Aug 2004 18:06:36 +0000 |
| Subject: | Re: Proposal: CHANGELOG | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969363228@lists.php.net to get a copy of this message | ||
> >
> > http://livedocs.phpp.org/index.php?l=en&q=function.exif-thumbnail
> >
> > As far as rendering, right now & and [] are typed into the parameter
> > listing and this feels dirty. If we could use a role with the parameter
> > tag (Curt suggested this in irc) it might solve this. For example:
> >
> > [<parameter role="ref">width</parameter>]
> >
> > This way we'd not have to type & in the parameter listing, or in the
> > methodsynopsis. For non-methodparam use we might either add a role like
> > "refopt" or type it out:
> >
> > <parameter role="ref" choice="opt">width</parameter>
> >
> > But anyway Goba what tags (if any) do you suggest for this?
>
> This last option seems to be fine with me.
Should go as far as adding the type here too?
<type>integer</type> <parameter role="ref"
choice="opt">width</parameter>
VS
<parameter role="ref" choice"opt"
type="integer">width</parameter>
Regards,
Philip