From: | Thom Brown <thom(at)linux(dot)com> |
---|---|
To: | Kevin Grittner <Kevin(dot)Grittner(at)wicourts(dot)gov> |
Cc: | Alvaro Herrera <alvherre(at)commandprompt(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org> |
Subject: | Re: SGML on functions |
Date: | 2010-08-29 15:54:31 |
Message-ID: | AANLkTinvqtDHe74rnzzGknJhZ=g++MUc+-65GjYNgO90@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On 29 August 2010 16:21, Kevin Grittner <Kevin(dot)Grittner(at)wicourts(dot)gov> wrote:
> 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>
>
But that page also says "Using FuncSynopsis for languages that are
unrelated to C may prove difficult."
Using that syntax will result in a semi-colon being placed at the end
of the function when parsed.
--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935
From | Date | Subject | |
---|---|---|---|
Next Message | Joe Conway | 2010-08-29 16:20:55 | Re: [pgsql-www] Example indenting |
Previous Message | Kevin Grittner | 2010-08-29 15:21:59 | Re: SGML on functions |