pgsql: Consolidate docs for vacuum-related GUCs in new subsection

From: Melanie Plageman <melanieplageman(at)gmail(dot)com>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Consolidate docs for vacuum-related GUCs in new subsection
Date: 2025-01-10 23:22:56
Message-ID: E1tWOL9-000tpi-PU@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-hackers

Consolidate docs for vacuum-related GUCs in new subsection

GUCs related to vacuum's freezing behavior were documented in a
subsection of the Client Connection Defaults documentation. These GUCs
don't belong there, as they affect the freezing behavior of all vacuums
-- including autovacuums.

There wasn't a clear alternative location, so this commit makes a new
"Server Configuration" docs subsection, "Vacuuming", with a subsection
for "Freezing". It also moves the "Automatic Vacuuming" subsection and
the docs on GUCs controlling cost-based vacuum delay under the new
"Vacuuming" subsection.

The other vacuum-related GUCs under the "Resource Consumption"
subsection have been left in their current location, as they seem to fit
there.

The GUCs' documentation was largely lifted and shifted. The only
modification made was the addition of a few missing <literal> tags.

Reviewed-by: Daniel Gustafsson <daniel(at)yesql(dot)se>
Discussion: https://postgr.es/m/flat/CAAKRu_aQUOaMYrcjNuXeSkJtaX9oRUzKP57bsYbC0gVVWS%2BcbA%40mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/ca9c6a5680d7c7dece0f7209ee7ce20c9dfe0840

Modified Files
--------------
doc/src/sgml/config.sgml | 1254 ++++++++++++++++++++++++----------------------
1 file changed, 643 insertions(+), 611 deletions(-)

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Tatsuo Ishii 2025-01-10 23:24:42 pgsql: Add new StringInfo APIs to allow callers to specify the buffer s
Previous Message Daniel Gustafsson 2025-01-10 21:21:02 pgsql: Fix missing ldapscheme option in pg_hba_file_rules()

Browse pgsql-hackers by date

  From Date Subject
Next Message Tatsuo Ishii 2025-01-10 23:25:48 Re: Proposal: add new API to stringinfo
Previous Message David Rowley 2025-01-10 23:17:23 Re: Restore support for USE_ASSERT_CHECKING in extensions only