Re: SGML on functions - Mailing list pgsql-docs

From Kevin Grittner
Subject Re: SGML on functions
Date
Msg-id 4C7A34C70200002500034DB5@gw.wicourts.gov
Whole thread Raw
In response to Re: SGML on functions  (Alvaro Herrera <alvherre@commandprompt.com>)
Responses Re: SGML on functions  (Thom Brown <thom@linux.com>)
List pgsql-docs
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

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: libpq (PQprepared)
Next
From: "Kevin Grittner"
Date:
Subject: Re: [pgsql-www] Example indenting