Re: SGML on functions

Alvaro Herrera <alvherre@commandprompt.com> wrote:
> Excerpts from Thom Brown's message:

>> <function>variance</function>(<replaceable
>> class="parameter">expression</replaceable>)
>>
>> vs
>>
>> <function>stddev_samp(<replaceable
>> class="parameter">expression</replaceable>)</function>
>>
>> Which way is correct?
>
> The latter I think -- see
> http://www.docbook.org/tdg/en/html/function.html
> (but perhaps search the actual standard)

Nothing I saw at that link suggests that the parameters should be
included within the <function> scope.  If you follow links from
there to here:

http://www.docbook.org/tdg/en/html/funcsynopsis.html

You find examples like this:

<funcsynopsis>
<funcprototype>
  <funcdef>void <function>qsort</function></funcdef>
    <paramdef>void *<parameter>dataptr</parameter>[]</paramdef>
    <paramdef>int <parameter>left</parameter></paramdef>
    <paramdef>int <parameter>right</parameter></paramdef>
    <paramdef>int <parameter>(* comp)</parameter>
      <funcparams>void *, void *</funcparams></paramdef>
</funcprototype>
</funcsynopsis>

-Kevin