In light of the a recent bug with the run time call by reference examples. I started going through and finding the examples that have used the &$var syntax.
I was thinking, perhaps the proto should reflect that that the parameter is passed by reference:
array getimagesize ( string filename [, array &imageinfo])
I can think of two solutions that could work:
Adding an attribute to the <parameter>: <parameter option="ref">imaginfo</parameter>
With the common.xsl: <xsl:template match="methodparam/parameter"> <xsl:if test="@option='ref'"> <xsl:text>&</xsl:text> </xsl:if> <xsl:apply-templates /> </xsl:template>
Or simply adding & the the paramater value.
Any comments on this?
I have not looked into this if this is valid DocBook syntax, but it would be nice if it would be. Also you need to modify the DSSSL sheets to, because most of the manuals are still generated via the DSSSL sheets (online HTML, downloadable HTML and CHMs).
Goba
