Re: pgsql: Consolidate docs for vacuum-related GUCs in new subsection
Alvaro Herrera <alvherre@alvh.no-ip.org>
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: Melanie Plageman <melanieplageman@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, Daniel Gustafsson <daniel@yesql.se>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2025-01-13T20:46:40Z
Lists: pgsql-hackers
On 2025-Jan-13, Melanie Plageman wrote: > Since I didn't hear back about this and I don't see an obvious > alternative reorganization in guc_tables.c, I plan to just push the > attached patch that updates only postgresql.conf.sample. Apologies, I was very unclear -- I didn't want to talk about the ordering of entries in the code, but the categorization. See the config_group_names list in guc_tables.c, which defines some groups. Each setting belongs into a group, and those groups correspond to what the sample config file lists as section/subsection titles and to the grouping in the docs. Also, this categorization affects how the entries are listed in the pg_settings view and in "postgres --describe-config", which feed from the same tables. Perhaps with your changes (assuming I read your commit message right), we need new groups: VACUUMING VACUUMING_FREEZING VACUUMING_AUTOVACUUM Thanks -- Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/ "Doing what he did amounts to sticking his fingers under the hood of the implementation; if he gets his fingers burnt, it's his problem." (Tom Lane)
Commits
-
Synchronize guc_tables.c categories with vacuum docs categories
- 2ae98ea5ab8f 18.0 landed
-
Reorder vacuum GUCs in postgresql.conf.sample to match docs
- af2317652d5d 18.0 landed
-
Consolidate docs for vacuum-related GUCs in new subsection
- ca9c6a5680d7 18.0 cited