pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: David G. Johnston <david.g.johnston@gmail.com>
Cc: masondeanm@aol.com <masondeanm@aol.com>
Cc: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Subject: Re: INSERT ... RETURNING documentation
Date: Thu, 25 Jul 2024 17:42:03 -0400
Message-ID: <1566148.1721943723@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKFQuwYZJykuHnbc3d_Ks2mQyca6cB0JeoWVHLsBPphgNbXgCQ@mail.gmail.com>
References: <172193970148.915373.2403176471224676074@wrigleys.postgresql.org>
	<CAKFQuwYZJykuHnbc3d_Ks2mQyca6cB0JeoWVHLsBPphgNbXgCQ@mail.gmail.com>

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Thursday, July 25, 2024, PG Doc comments form <noreply@postgresql.org>
> wrote:
>> The grammar
>> [ RETURNING * | output_expression [ [ AS ] output_name ] [, ...] ]
>> seems wrong to me.

> Yes, the word returning makes it the returning clause.  This should be
> written:

> [ Returning { * | output_expression [ [ AS ] output_name ] } [, …] ]

Agreed.

> Related, select says:

> [ * | expression [ [ AS ] output_name ] [, …] ]

I imagine the RETURNING synopsis was copied from that one :-(
Yes, let's change that too.

			regards, tom lane





view thread (3+ messages)

Message-ID: <1566148.1721943723@sss.pgh.pa.us>
Permalink:  ../1566148.1721943723@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/1566148.1721943723@sss.pgh.pa.us

 · 

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: tgl@sss.pgh.pa.us, david.g.johnston@gmail.com, masondeanm@aol.com, pgsql-docs@lists.postgresql.org
  Subject: Re: INSERT ... RETURNING documentation
  In-Reply-To: <1566148.1721943723@sss.pgh.pa.us>

* 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