Re: Two fixes for plpgsql.sgml

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Guillaume Lelarge <guillaume(at)lelarge(dot)info>
Cc: Neil Conway <neilc(at)samurai(dot)com>, pgsql-docs(at)postgresql(dot)org
Subject: Re: Two fixes for plpgsql.sgml
Date: 2007-11-28 20:15:57
Message-ID: 200711282015.lASKFve27538@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Guillaume Lelarge wrote:
> Neil Conway a ?crit :
> > On Wed, 2007-11-28 at 08:17 +0100, Guillaume Lelarge wrote:
> >> This patch fixes two issues on plpgsql.sgml.
> >
> > The first hunk seems like a regression to me: AFAICS the current
> > phrasing is what is intended.
> >
> > *** 133,139 ****
> >
> > <para>
> > <application>PL/pgSQL</> functions can also be declared to return
> > ! a <quote>set</>, or table, of any data type they can return a
> > single
> > instance of. 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
> > --- 133,139 ----
> >
> > <para>
> > <application>PL/pgSQL</> functions can also be declared to return
> > ! a <quote>set</>, or table, or any data type they can return a
> > single
> > instance of. 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
> >
>
> That's why I said that it needs to be reviewed carefully :) It just
> means I didn't understand the sentence. Can you explain why the last
> part is needed ? (the part that starts with "of any data type...")

Agreed. I couldn't find any value to that phrase and couldn't find better
wording, so I removed it. Patch attached and applied.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

Attachment Content-Type Size
/rtmp/diff text/x-diff 1.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David Fetter 2007-11-28 20:26:15 Partition: use triggers instead of rules
Previous Message Simon Riggs 2007-11-28 13:39:32 Re: PITR Doc clarifications