pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Bruce Momjian <bruce@momjian.us>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Guillaume Lelarge <guillaume@lelarge.info>
Cc: Neil Conway <neilc@samurai.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Two fixes for plpgsql.sgml
Date: Wed, 28 Nov 2007 18:40:36 -0300
Message-ID: <20071128214036.GW5118@alvh.no-ip.org> (raw)
In-Reply-To: <200711282057.lASKvSt19769@momjian.us>
References: <20923.1196282281@sss.pgh.pa.us>
	<200711282057.lASKvSt19769@momjian.us>

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)



view thread (9+ messages)  latest in thread

Message-ID: <20071128214036.GW5118@alvh.no-ip.org>
Permalink:  ../20071128214036.GW5118@alvh.no-ip.org/
Also on:    postgresql.org/message-id/20071128214036.GW5118@alvh.no-ip.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: alvherre@alvh.no-ip.org, bruce@momjian.us, tgl@sss.pgh.pa.us, guillaume@lelarge.info, neilc@samurai.com
  Subject: Re: Two fixes for plpgsql.sgml
  In-Reply-To: <20071128214036.GW5118@alvh.no-ip.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox