From: Tom Lane <tgl@sss.pgh.pa.us>
To: Michael Paquier <michael@paquier.xyz>
cc: Bruce Momjian <bruce@momjian.us>, Justin Pryzby <pryzby@telsasoft.com>,
        pgsql-hackers@lists.postgresql.org
Subject: Re: [PATCH] force_parallel_mode and GUC categories
In-reply-to: <YHVJfw2YN5/oGAcQ@paquier.xyz>
References: <20210403151201.GD29125@momjian.us>
 <3972636.1617464359@sss.pgh.pa.us> <20210403154114.GJ6592@telsasoft.com>
 <20210403154336.GG29125@momjian.us> <20210404012546.GK6592@telsasoft.com>
 <YG+y/eJErKPDUhiS@paquier.xyz> <20210409031718.GO6592@telsasoft.com>
 <20210409113928.GA12919@momjian.us> <YHPUHdXuCzMIROf9@paquier.xyz>
 <2746080.1618206052@sss.pgh.pa.us> <YHVJfw2YN5/oGAcQ@paquier.xyz>
Comments: In-reply-to Michael Paquier <michael@paquier.xyz>
	message dated "Tue, 13 Apr 2021 16:34:23 +0900"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <3188887.1618323155.1@sss.pgh.pa.us>
Date: Tue, 13 Apr 2021 10:12:35 -0400
Message-ID: <3188888.1618323155@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/3188888.1618323155%40sss.pgh.pa.us>
Precedence: bulk

Michael Paquier <michael@paquier.xyz> writes:
> On Mon, Apr 12, 2021 at 01:40:52AM -0400, Tom Lane wrote:
>> Perhaps ... what did you have in mind?

> The first sentence of the page now says that:
> "The following parameters are intended for work on the PostgreSQL
> source code, and in some cases to assist with recovery of severely
> damaged databases."

> That does not stick with force_parallel_mode IMO.  Maybe:
> "The following parameters are intended for development work related to
> PostgreSQL.  Some of them work on the PostgreSQL source code, some of
> them can be used to control the run-time behavior of the server, and
> in some cases they can be used to assist with the recovery of severely
> damaged databases."

I think that's overly wordy.  Maybe

The following parameters are intended for developer testing, and
should never be enabled for production work.  However, some of
them can be used to assist with the recovery of severely
damaged databases.

			regards, tom lane