Re: `transaction_read_only` GUC undocumented - Mailing list pgsql-docs

From Michael Paquier
Subject Re: `transaction_read_only` GUC undocumented
Date
Msg-id 20190123061422.GK3873@paquier.xyz
Whole thread Raw
In response to Re: `transaction_read_only` GUC undocumented  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: `transaction_read_only` GUC undocumented  (Pavlo Golub <pavlo.golub@cybertec.at>)
List pgsql-docs
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.
>
> 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

Attachment

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: `transaction_read_only` GUC undocumented
Next
From: Pavlo Golub
Date:
Subject: Re: `transaction_read_only` GUC undocumented