Date: Wed, 23 Jan 2019 15:14:22 +0900
From: Michael Paquier <michael@paquier.xyz>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Pavlo Golub <pavlo.golub@cybertec.at>, pgsql-docs@lists.postgresql.org
Subject: Re: `transaction_read_only` GUC undocumented
Message-ID: <20190123061422.GK3873@paquier.xyz>
References: <20190123002536.GC3873@paquier.xyz>
 <18fa8fbf-f5a3-4e4b-b751-8b9da58c117c@email.android.com>
 <20190123055440.GI3873@paquier.xyz>
 <4210.1548223651@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
	protocol="application/pgp-signature"; boundary="gw4vLALk08fVJy3V"
Content-Disposition: inline
In-Reply-To: <4210.1548223651@sss.pgh.pa.us>
Precedence: bulk


--gw4vLALk08fVJy3V
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jan 23, 2019 at 01:07:31AM -0500, Tom Lane wrote:
> Michael Paquier <michael@paquier.xyz> writes:
>> transaction_read_only is listed in src/backend/utils/misc/guc.c, so we
>> could put a description close to default_transaction_read_only in
>> config.sgml, except that transaction_read_only sets the current
>> transaction's read-only status.
>=20
> Do we really want to document that?  It's not the standard-approved
> way of making a transaction read-only.

i'd rather document them clearly rather than letting them around with
users guessing what they actually do (remember the recent thread about
replication parameter in connection strings).  By the way, I can see
that transaction_deferrable and transaction_isolation are not around
either...
--
Michael

--gw4vLALk08fVJy3V
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAlxIBj4ACgkQnvQgOdby
QH3nmBAAlBmKyR/H9ipy8qoCx/FW7lu4E+1JbHm2QddSr+U1tZSk2ZDCG+WoqzQp
jAYkF1pwllOPBhc/2LYX1nGc1/QC+7slWPG0wz07ZT4x95n8noKGcl7FBFoCZR0A
aOQmKZj0D+KootC4FPKHC/k8l81mQ6fsA+8u9C850Go89PbDuWF1mKtKqBNvEQJp
Jr7b5OvVs5Xt+mTZ5xv4WFU+MeU1tAhku9y/gYnQfvHksHYAzUQCNEyz0XMqd424
UI2IC4WqhQiMl0Opky8dqi4K7+JzVF2EVWHm4TLqC0ExTws0WPYdw1Fz2ft9istp
5NEMgElVvfy5Em52bXXHNWbfwJi70IOPKRWmBD9FHrHpSGgZOR8H0Rs8En1E7K+M
M/9jM6v6xe+WtmVRjtH2xgQP3gGdtgsqDevFtN8sEGmoO0AOSJIUXVDgdt5hALJ6
RPBlOTD36ZwnMO+v4pSotvXyczkvX3pzo5DMmXMynyc9yPFbFxJ6crQ/SxKGlmcr
B+A4t3/Jts4CLXSyyjuqQ4C9wSbeGqW3UiWPG5Xc1yVgqMvMScr1WAstfirRz5SU
red9R89eGCjcNfe0w7Vq/Cg/i9jo5TNgMYQVfTnUwgJHoTp1Wyg5wYyVziLQrja9
Gb78DXZh9fkaRRINVIStSKsnDFnGkDuKd+WF80IAaHOyqUerNgc=
=a5Hw
-----END PGP SIGNATURE-----

--gw4vLALk08fVJy3V--