Re: SGML on functions - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: SGML on functions
Date
Msg-id 1282948205-sup-3873@alvh.no-ip.org
Whole thread Raw
In response to SGML on functions  (Thom Brown <thom@linux.com>)
Responses Re: SGML on functions  ("Kevin Grittner" <Kevin.Grittner@wicourts.gov>)
List pgsql-docs
Excerpts from Thom Brown's message of vie ago 27 14:56:04 -0400 2010:
> Copied from another thread...
>
> Something I've noticed is an inconsistency in the SGML markup around
> functions listed in tables.  Sometimes the entire function signature
> is considered to be the function, and other times it's just the
> function name, with its parameters outside of the <function> tags.
>
> E.g.:
>
> <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)

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

pgsql-docs by date:

Previous
From: Thom Brown
Date:
Subject: Re: SGML on functions
Next
From: "Joshua D. Drake"
Date:
Subject: Re: [DOCS] Example indenting