Confusing reference to MERGE use inside WITH

From: PG Doc comments form <noreply(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: rasmus(at)porsager(dot)com
Subject: Confusing reference to MERGE use inside WITH
Date: 2023-07-15 14:37:00
Message-ID: 168943182036.41166.8772603694562251850@wrigleys.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/15/queries-with.html
Description:

Hi.

In the queries WITH documentation
https://www.postgresql.org/docs/15/queries-with.html it is a bit confusing
that MERGE is referenced in several places as being something you can use
inside with, even though it can't.

If you search for MERGE on the page, you will find the 2 first results is a
reference saying MERGE can be used inside WITH, the same as SELECT, INSERT,
UPDATE, or DELETE. The 3rd result then correctly states that MERGE cannot be
used inside WITH.

If I'm misunderstanding the meaning of the first 2 results, then I apologise
:)

Greetings
Rasmus Porsager

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message jian he 2023-07-17 01:16:58 Re: Confusing reference to MERGE use inside WITH
Previous Message PG Doc comments form 2023-07-15 05:57:40 Improvement of clarity in pg_ctl command docummentation