Re: describe special values in GUC descriptions more consistently
Nathan Bossart <nathandbossart@gmail.com>
From: Nathan Bossart <nathandbossart@gmail.com>
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: Peter Smith <smithpb2250@gmail.com>, Daniel Gustafsson <daniel@yesql.se>, PostgreSQL Hackers <pgsql-hackers@postgresql.org>
Date: 2025-02-13T22:18:43Z
Lists: pgsql-hackers
Attachments
On Wed, Feb 12, 2025 at 04:10:53PM -0700, David G. Johnston wrote: > I presume it doesn't affect the actual output which just concatenates the > fragments together but the source placement probably should be made > consistent; the line containing the initial default value specification > begins its own quoted fragment. The following violate that convention. Eh, most of the other descriptions with multiple sentences don't do that, so IMHO there's no need for the special values to go in their own fragment. You are correct that there should be no difference in the actual output. > Also, maybe put the rules in the commit message into a comment in the file, > or a README, instead. I added a comment to guc_tables.h in v6. -- nathan
Commits
-
Adjust auto_explain's GUC descriptions.
- e636da920028 18.0 landed
-
Describe special values in GUC descriptions more consistently.
- 977d865c36cc 18.0 landed