Re: 'value' has special behaviour in alter system - Mailing list pgsql-docs

From Tom Lane
Subject Re: 'value' has special behaviour in alter system
Date
Msg-id 3417417.1671124227@sss.pgh.pa.us
Whole thread Raw
In response to Re: 'value' has special behaviour in alter system  ("Jonathan S. Katz" <jkatz@postgresql.org>)
Responses Re: 'value' has special behaviour in alter system
List pgsql-docs
"Jonathan S. Katz" <jkatz@postgresql.org> writes:
> On 12/15/22 10:50 AM, David G. Johnston wrote:
>> I suggest changing it to:
>> SET configuration_parameter { TO | = } { value [, ...] | DEFAULT }

> +1 in general. I would also suggest we add an example in the Examples 
> section to show what the output is when you add single-quotes.

I think the core problem here is that the syntax diagram and discussion
don't clearly discuss the behavior for list values.  David's version of
the syntax diagram looks fine, but not sure about the text.  There likely
needs to be some explicit acknowledgement of the fact that some GUCs
act differently than others (cf GUC_LIST_INPUT and GUC_LIST_QUOTE flags).

+1 for examples, for sure.

            regards, tom lane



pgsql-docs by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Re: 'value' has special behaviour in alter system
Next
From: PG Doc comments form
Date:
Subject: Addition of Github link to odument