Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id 5AFBA632530
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri, 27 Aug 2010 19:32:07 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024) with ESMTP id 96576-04 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Fri, 27 Aug 2010 22:31:58 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from spinlock.commandprompt.com (host-215.commandprompt.net
	[207.173.203.215])
	by mail.postgresql.org (Postfix) with ESMTP id AAE1A633439
	for <pgsql-docs@postgresql.org>; Fri, 27 Aug 2010 19:31:51 -0300 (ADT)
Received: from localhost (localhost [127.0.0.1])
	by spinlock.commandprompt.com (Postfix) with ESMTP id 45A61348011;
	Fri, 27 Aug 2010 15:31:41 -0700 (PDT)
X-Virus-Scanned: Debian amavisd-new at commandprompt.com
Received: from spinlock.commandprompt.com ([127.0.0.1])
	by localhost (spinlock.commandprompt.com.commandprompt.com [127.0.0.1])
	(amavisd-new, port 10024)
	with ESMTP id X1s00yxbEx1F; Fri, 27 Aug 2010 15:31:29 -0700 (PDT)
Received: from perhan.alvh.no-ip.org (200-85-200-241.bk3-dsl.surnet.cl
	[200.85.200.241])
	by spinlock.commandprompt.com (Postfix) with ESMTPSA id 3376A348012;
	Fri, 27 Aug 2010 15:31:29 -0700 (PDT)
Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000)
	id 74C236E5F1; Fri, 27 Aug 2010 18:31:24 -0400 (CLT)
Content-Type: text/plain; charset=UTF-8
Cc: pgsql-docs <pgsql-docs@postgresql.org>
Subject: Re: SGML on functions
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Thom Brown <thom@linux.com>
In-reply-to: <AANLkTi=cLJcfZo_oMFFrRveiOyCVz1DcPhizqgLbJ7rJ@mail.gmail.com>
References: <AANLkTi=cLJcfZo_oMFFrRveiOyCVz1DcPhizqgLbJ7rJ@mail.gmail.com>
Date: Fri, 27 Aug 2010 18:31:24 -0400
Message-Id: <1282948205-sup-3873@alvh.no-ip.org>
User-Agent: Sup/git
Content-Transfer-Encoding: 8bit
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.9 tagged_above=-5 required=5 tests=BAYES_00=-1.9
X-Spam-Level: 
X-Archive-Number: 201008/107
X-Sequence-Number: 5931

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