Re: GUC names in messages[
Michael Paquier <michael@paquier.xyz>
From: Michael Paquier <michael@paquier.xyz>
To: Peter Smith <smithpb2250@gmail.com>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>, Nathan Bossart <nathandbossart@gmail.com>, Laurenz Albe <laurenz.albe@cybertec.at>, Peter Eisentraut <peter@eisentraut.org>, Tom Lane <tgl@sss.pgh.pa.us>, Daniel Gustafsson <daniel@yesql.se>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-11-27T04:06:30Z
Lists: pgsql-hackers
On Mon, Nov 27, 2023 at 01:41:18PM +1100, Peter Smith wrote: > TBH, I suspect something fishy about these mixed-case GUCs. > > In the documentation and in the guc_tables.c they are all described in > MixedCase (e.g. "DateStyle" instead of "datestyle"), so I felt the > messages should use the same case the documentation, which is why I > changed all the ones you are referring to. FWIW, I've been tempted for a few years to propose that we should keep the parsers as they behave now, but format the name of these parameters in the code and the docs to just be lower-case all the time. >> Is there a reason why we don't just use islower() or is that just to >> get something entirely local independent? I am not sure that it needs >> to be that complicated. We should just check that all the characters >> are lower-case and apply quotes. > > Thanks for the feedback. Probably I have overcomplicated it. I'll revisit it. The use of a static variable with a fixed size was itching me a bit as well.. I was wondering if it would be cleaner to use %s%s%s in the strings adding a note that these are GUC names that may be optionally quoted, then hide what gets assigned in a macro with a result rather similar to LSN_FORMAT_ARGS (GUC_FORMAT?). The routine checking if quotes should be applied would only need to return a boolean to tell what to do, and could be hidden in the macro. -- Michael
Commits
-
Apply GUC name from central table in more places of guc.c
- f3f06b13308e 18.0 landed
-
Use camel case for "DateStyle" in some error messages
- 2e7c4abe5a88 18.0 landed
-
Unify some error messages to ease work of translators
- a68159ff2b32 18.0 landed
-
Apply more quoting to GUC names in messages
- b4db64270e0c 18.0 landed
-
Revise GUC names quoting in messages again
- 17974ec25946 17.0 landed
-
doc: Mention how to use quotes with GUC names in error messages
- a243569bf65c 17.0 landed
-
Apply quotes more consistently to GUC names in logs
- 8d9978a7176a 17.0 landed