Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id 1A9D76323BD
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sun, 29 Aug 2010 13:24:24 -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 44355-08 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Sun, 29 Aug 2010 16:24:16 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from gw.wicourts.gov (gwmta.wicourts.gov [165.219.244.99])
	by mail.postgresql.org (Postfix) with ESMTP id D7C2A63308B
	for <pgsql-docs@postgresql.org>; Sun, 29 Aug 2010 13:24:16 -0300 (ADT)
Received: from Courts-MTA by gw.wicourts.gov
	with Novell_GroupWise; Sun, 29 Aug 2010 11:24:15 -0500
Message-Id: <4C7A43530200002500034DBB@gw.wicourts.gov>
X-Mailer: Novell GroupWise Internet Agent 8.0.1 
Date: Sun, 29 Aug 2010 11:24:03 -0500
From: "Kevin Grittner" <Kevin.Grittner@wicourts.gov>
To: "Thom Brown" <thom@linux.com>
Cc: "Alvaro Herrera" <alvherre@commandprompt.com>,
	"pgsql-docs" <pgsql-docs@postgresql.org>
Subject: Re: SGML on functions
References: <AANLkTi=cLJcfZo_oMFFrRveiOyCVz1DcPhizqgLbJ7rJ@mail.gmail.com>
	<1282948205-sup-3873@alvh.no-ip.org>
	<4C7A34C70200002500034DB5@gw.wicourts.gov>
	<AANLkTinvqtDHe74rnzzGknJhZ=g++MUc+-65GjYNgO90@mail.gmail.com>
In-Reply-To: <AANLkTinvqtDHe74rnzzGknJhZ=g++MUc+-65GjYNgO90@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-4.21 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	RCVD_IN_DNSWL_MED=-2.3, T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201008/125
X-Sequence-Number: 5949

Thom Brown <thom@linux.com> wrote:
> Kevin Grittner <Kevin.Grittner@wicourts.gov> wrote:
 
>>  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.
 
Yes, but that's the only place I could find an example of function
and parameter together.  The parameter tag can be used inside of
function as well as in most of the places function can be used, so
the definition seemed ambiguous to me.  I took these examples as
being the best evidence I could find about whether parameter tags
were intended to be inside or outside of the function tag.
 
I suppose an argument could be made that for functions for which the
identity is totally determined by function name (as in C) the
parameters should be outside the tag, while functions in SQL need
the parameters inside the tag, because they are used to identify a
particular function among many with the same name.
 
It appears that, technically, either format is allowed.
 
-Kevin