Re: Proposal: CHANGELOG

From: Date: Mon, 16 Aug 2004 16:10:21 +0000
Subject: Re: Proposal: CHANGELOG
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969363226@lists.php.net to get a copy of this message
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 &amp; 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 &amp; 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. Goba

« previous php.doc (#969363226) next »