MIME-Version: 1.0
From: =?UTF-8?B?w4FsdmFybyBSb2Ryw61ndWV6?=
 <alvarorodriguez.garcia@datadoghq.com>
Date: Fri, 27 Mar 2026 17:23:43 +0100
Message-ID: 
 <CA+C_kKVH5gRJg4a+pQjX4LDwvWzWwoDWBV8-_E-wXnZdFKrRXA@mail.gmail.com>
Subject: Update documentation for SET to include SCHEMA / NAMES syntax
To: pgsql-hackers@lists.postgresql.org
Content-Type: multipart/mixed; boundary="0000000000006a1f35064e03eddd"
Archived-At: 
 <https://www.postgresql.org/message-id/CA%2BC_kKVH5gRJg4a%2BpQjX4LDwvWzWwoDWBV8-_E-wXnZdFKrRXA%40mail.gmail.com>
Precedence: bulk

--0000000000006a1f35064e03eddd
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Hi,

The attached patch updates the documentation for the SET statement to
include the special syntax for SCHEMA / NAMES in the synopsis. The
current documentation only mentions this special syntax under the
parameters, which is confusing and different from the usual practice.

We could consider also moving the description on the special syntax up
to the description instead of keeping it under parameters, but the
TIME ZONE variant is already explained under the parameters too so I
thought better to keep the current structure.

Thanks,
=C3=81lvaro Rodr=C3=ADguez

--0000000000006a1f35064e03eddd
Content-Type: application/octet-stream;
	name="v1-0001-Update-the-SET-statement-documentation-for-clarit.patch"
Content-Disposition: attachment;
	filename="v1-0001-Update-the-SET-statement-documentation-for-clarit.patch"
Content-Transfer-Encoding: base64
Content-ID: <f_mn9400oc0>
X-Attachment-Id: f_mn9400oc0

RnJvbSA1YjY3MWU1NGRhNTNmMzY3N2VlMDdjZjk3NjkxOTZhZTRlZmFiMjQwIE1vbiBTZXAgMTcg
MDA6MDA6MDAgMjAwMQpGcm9tOiA9P1VURi04P3E/PUMzPTgxbHZhcm89MjBSb2RyPUMzPUFEZ3Vl
ej89CiA8YWx2YXJvcm9kcmlndWV6LmdhcmNpYUBkYXRhZG9naHEuY29tPgpEYXRlOiBUaHUsIDI2
IE1hciAyMDI2IDE3OjU2OjE3ICswMTAwClN1YmplY3Q6IFtQQVRDSCB2MSAxLzFdIFVwZGF0ZSB0
aGUgU0VUIHN0YXRlbWVudCBkb2N1bWVudGF0aW9uIGZvciBjbGFyaXR5CiB3aGVuIHVzaW5nIFND
SEVNQSBhbmQgTkFNRVMKCkFkZGVkIGEgbmV3IHZhcmlhbnQgdG8gdGhlIFNFVCBzdGF0ZW1lbnQg
dG8gaW5jbHVkZSB0aGUgc3BlY2lhbCBzeW50YXggZm9yIFNFVCBTQ0hFTUEgYW5kIFNFVCBOQU1F
Uy4KLS0tCiBkb2Mvc3JjL3NnbWwvcmVmL3NldC5zZ21sIHwgMSArCiAxIGZpbGUgY2hhbmdlZCwg
MSBpbnNlcnRpb24oKykKCmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvcmVmL3NldC5zZ21sIGIv
ZG9jL3NyYy9zZ21sL3JlZi9zZXQuc2dtbAppbmRleCAxNmM3ZTlhN2IyNi4uNjM4NDNhNmI4NWMg
MTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9yZWYvc2V0LnNnbWwKKysrIGIvZG9jL3NyYy9zZ21s
L3JlZi9zZXQuc2dtbApAQCAtMjIsNiArMjIsNyBAQCBQb3N0Z3JlU1FMIGRvY3VtZW50YXRpb24K
ICA8cmVmc3lub3BzaXNkaXY+CiA8c3lub3BzaXM+CiBTRVQgWyBTRVNTSU9OIHwgTE9DQUwgXSA8
cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+Y29uZmlndXJhdGlvbl9wYXJhbWV0ZXI8L3Jl
cGxhY2VhYmxlPiB7IFRPIHwgPSB9IHsgPHJlcGxhY2VhYmxlIGNsYXNzPSJwYXJhbWV0ZXIiPnZh
bHVlPC9yZXBsYWNlYWJsZT4gWywgLi4uXSB8IERFRkFVTFQgfQorU0VUIFsgU0VTU0lPTiB8IExP
Q0FMIF0gWyBTQ0hFTUEgfCBOQU1FUyBdIHsgJzxyZXBsYWNlYWJsZSBjbGFzcz0icGFyYW1ldGVy
Ij52YWx1ZTwvcmVwbGFjZWFibGU+JyB9CiBTRVQgWyBTRVNTSU9OIHwgTE9DQUwgXSBUSU1FIFpP
TkUgeyA8cmVwbGFjZWFibGUgY2xhc3M9InBhcmFtZXRlciI+dmFsdWU8L3JlcGxhY2VhYmxlPiB8
IExPQ0FMIHwgREVGQVVMVCB9CiA8L3N5bm9wc2lzPgogIDwvcmVmc3lub3BzaXNkaXY+Ci0tIAoy
LjUyLjAKCg==
--0000000000006a1f35064e03eddd--