Re: BUG #5968: DOCUMENTATION: SELECT synopsis omits RETURNING keyword

Gavin Flower <GavinFlower(at)archidevsys(dot)co(dot)nz> writes:
> I found were RETURNING is defined, so I was confused...
> ...
> However, may be it would still be good to mention it on the SELECT page?

It is mentioned --- the subsection on the WITH clause points out that
you typically want to use RETURNING on an INSERT/UPDATE/DELETE in WITH.

I thought about providing an example, but couldn't come up with one that
was both simple and compelling. There's no strong reason to do WITH
(something RETURNING) SELECT ... --- you might as well just do the work
in a straight "something RETURNING" statement. To do something that
actually requires the more complex syntax, you'd need to join the
RETURNING result to another table or another RETURNING result.
Creating an easily understandable example that involves that is beyond
my powers at this time of the morning.

regards, tom lane