Sort guc_parameters.dat alphabetically by name
authorPeter Eisentraut <peter@eisentraut.org>
Mon, 3 Nov 2025 08:37:20 +0000 (09:37 +0100)
committerPeter Eisentraut <peter@eisentraut.org>
Mon, 3 Nov 2025 09:04:14 +0000 (10:04 +0100)
commitfce7c73fba4e5e3014c27b8980aa07511d6e0f85
tree08af1812205897150a93814200b1ad5318dad7a3
parent8f29467c57f44cc2cdd9e4e53c6ab1b07375d5b4
Sort guc_parameters.dat alphabetically by name

The order in this list was previously pretty random and had grown
organically over time.  This made it unnecessarily cumbersome to
maintain these lists, as there was no clear guidelines about where to
put new entries.  Also, after the merger of the type-specific GUC
structs, the list still reflected the previous type-specific
super-order.

By using alphabetical order, the place for new entries becomes clear,
and often related entries will be listed close together.

This patch reorders the existing entries in guc_parameters.dat, and it
also augments the generation script to error if an entry is found at
the wrong place.

Note: The order is actually checked after lower-casing, to handle the
likes of "DateStyle".

Reviewed-by: John Naylor <johncnaylorls@gmail.com>
Reviewed-by: Álvaro Herrera <alvherre@kurilemu.de>
Reviewed-by: Heikki Linnakangas <hlinnaka@iki.fi>
Discussion: https://www.postgresql.org/message-id/flat/8fdfb91e-60fb-44fa-8df6-f5dea47353c9@eisentraut.org
src/backend/utils/misc/gen_guc_tables.pl
src/backend/utils/misc/guc_parameters.dat