Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
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

pgsql-docs by date

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

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group