Re: Two fixes for plpgsql.sgml - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: Two fixes for plpgsql.sgml
Date
Msg-id 20071128214036.GW5118@alvh.no-ip.org
Whole thread Raw
In response to Re: Two fixes for plpgsql.sgml  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Two fixes for plpgsql.sgml  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
Bruce Momjian wrote:

> --- 132,142 ----
>       </para>
>
>       <para>
> !      <application>PL/pgSQL</> functions can also be declared to return a
> !      group of values, either as a single row, or a group of rows, like a
> !      table.  Such a function generates its output by executing
> !      <command>RETURN NEXT</> for each desired element of the result set,
> !      or by using <command>RETURN QUERY</> to output the result of
>        evaluating a query.
>       </para>

Hmm, ISTM the correct terminology is "set of rows".  I have never heard
of "a group of rows".  It seems to me the easiest way out of the problem
would have been substituting the commas in the original with parens:

     <application>PL/pgSQL</> functions can also be declared to return
     a <quote>set</> (or <quote>table</>) of any data type they can return a single
     instance of.

The point of "any datatype they can return a single instance of" is that
this can be a set of scalar values (e.g. "RETURNS SETOF int") or of a
complex type ("RETURNS SETOF table"), or anything else they can return a
single instance of :-P (SETOF anyelement?  SETOF table%TYPE?)

--
Alvaro Herrera                               http://www.PlanetPostgreSQL.org/
"World domination is proceeding according to plan"        (Andrew Morton)

pgsql-docs by date:

Previous
From: "Joshua D. Drake"
Date:
Subject: Re: [PATCHES] Partition: use triggers instead of rules
Next
From: Bruce Momjian
Date:
Subject: Re: Two fixes for plpgsql.sgml