> >>Type information and by reference passing should be included IMHO too. > >>BTW the names of the parameters are missing from > >> > >> http://livedocs.phpp.org/index.php?l=en&q=function.exif-thumbnail > > > > Livedocs does not handle parameters with & correctly, they show > > up blank. I'll clean exif up, and add the type information, and > > the ref although have we figured out a way to not confuse users > > with this yet? Meaning, not promote people to inapropriately pass > > parameters by reference at runtime. This still worries me. > > The rendering issues should be fixed in livedocs, and not the doc sources.
Done. But if this information is shown it seems we'd also have to include all parameter information, like if it's optional. Look again at the exif_thumbnail() docs for how this might look: 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? Regards, Philip
