doc: Improve a couple of places in the MERGE docs.
authorDean Rasheed
Wed, 13 Mar 2024 13:16:24 +0000 (13:16 +0000)
committerDean Rasheed
Wed, 13 Mar 2024 13:16:24 +0000 (13:16 +0000)
commit97d4262683acb586778af2b2a3721fa7cdc402f1
tree72cb0ab4d38657a661ab6212e42b78b5894cb336
parenta3da95deee38ee067b0bead639c830eacbe894d5
doc: Improve a couple of places in the MERGE docs.

In the synopsis, make the syntax for merge_update consistent with the
syntax for a plain UPDATE command. It was missing the optional "ROW"
keyword that can be used in a multi-column assignment, and the option
to assign from a multi-column subquery, both of which have been
supported by MERGE since it was introduced.

In the parameters section for the with_query parameter, mention that
WITH RECURSIVE isn't supported, since this is different from plain
INSERT, UPDATE, and DELETE commands. While at it, move that entry to
the top of the list, for consistency with the other pages.

Back-patch to v15, where MERGE was introduced.

Discussion: https://postgr.es/m/CAEZATCWoQyWkMFfu7JXXQr8dA6%3DgxjhYzgpuBP2oz0QoJTxGWw%40mail.gmail.com
doc/src/sgml/ref/merge.sgml