Re: SGML on functions

From: "Kevin Grittner" <Kevin(dot)Grittner(at)wicourts(dot)gov>
To: "Alvaro Herrera" <alvherre(at)commandprompt(dot)com>, "Thom Brown" <thom(at)linux(dot)com>
Cc: "pgsql-docs" <pgsql-docs(at)postgresql(dot)org>
Subject: Re: SGML on functions
Date: 2010-08-29 15:21:59
Message-ID: 4C7A34C70200002500034DB5@gw.wicourts.gov
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Alvaro Herrera <alvherre(at)commandprompt(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Thom Brown 2010-08-29 15:54:31 Re: SGML on functions
Previous Message Kevin Grittner 2010-08-29 15:10:21 Re: [pgsql-www] Example indenting