Re: 'value' has special behaviour in alter system

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
Cc: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, splarv(at)ya(dot)ru, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: 'value' has special behaviour in alter system
Date: 2022-12-15 17:10:27
Message-ID: 3417417.1671124227@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"Jonathan S. Katz" <jkatz(at)postgresql(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2022-12-16 13:28:43 Addition of Github link to odument
Previous Message Jonathan S. Katz 2022-12-15 16:50:33 Re: 'value' has special behaviour in alter system