Hello everyone,
I'd like to propose using the methodsynopsis format for callback
prototypes, on function references such as that for array_reduce.
<varlistentry>
<term><parameter>function</parameter></term>
<listitem>
<para>
The callback function.
</para>
<methodsynopsis>
<type>void</type><methodname>callback</methodname>
<methodparam><type>array</type><parameter
role="reference">result</parameter></methodparam>
<methodparam><type>mixed</type><parameter>item</parameter></methodparam>
</methodsynopsis>
</listitem>
</varlistentry>
This is rendered as such in the current styling of the online
documentation: http://i.imgur.com/cUAPt.png
Any objections? If we decide upon this format, I'd also go ahead and
update any existing documentation on functions that use callbacks.
Thanks,
Justin Martin