From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: "masondeanm@aol.com" <masondeanm@aol.com>,
        "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Subject: Re: INSERT ... RETURNING documentation
In-reply-to: 
 <CAKFQuwYZJykuHnbc3d_Ks2mQyca6cB0JeoWVHLsBPphgNbXgCQ@mail.gmail.com>
References: <172193970148.915373.2403176471224676074@wrigleys.postgresql.org>
 <CAKFQuwYZJykuHnbc3d_Ks2mQyca6cB0JeoWVHLsBPphgNbXgCQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Thu, 25 Jul 2024 14:27:08 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-ID: <1566147.1721943723.1@sss.pgh.pa.us>
Content-Transfer-Encoding: 8bit
Date: Thu, 25 Jul 2024 17:42:03 -0400
Message-ID: <1566148.1721943723@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/1566148.1721943723%40sss.pgh.pa.us>
Precedence: bulk

"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