Re: Moving the vacuum GUCs' docs out of the Client Connection Defaults section

From: Melanie Plageman <melanieplageman(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Pg Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Moving the vacuum GUCs' docs out of the Client Connection Defaults section
Date: 2025-01-07 17:15:17
Message-ID: CAAKRu_bz3BD4w0jmjfQkckAQE5eb-Ge2a=9Q-HG_rWSTeG_PzA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Jan 6, 2025 at 8:26 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Melanie Plageman <melanieplageman(at)gmail(dot)com> writes:
> > I was reviewing all the vacuum related GUCs, and I noticed that they
> > fall into three main subsections of Chapter 19 (Server Configuration)
> > in the docs [1]: Automatic Vacuuming [2], Resource Consumption [3],
> > and Client Connection Defaults [4]. The last one I find pretty
> > confusing.
>
> Yeah, it's a mess. It sounds good to consolidate all of those under
> a top-level Vacuuming section.

Cool, I've attached a patch to do this. I left a few of the GUCs under
Resource Consumption (like autovacuum_work_mem and
vacuum_buffer_usage_limit) where they are because it seemed
appropriate.

This is my first docs patch that introduces new sections and such, so
I'm not sure I got the indentation 100% correct (I, of course, tried
to follow conventions).

- Melanie

Attachment Content-Type Size
v1-0001-Consolidate-docs-for-vacuum-related-GUCs-in-new-s.patch text/x-patch 60.5 KB

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Nathan Bossart 2025-01-07 17:23:47 Re: allow changing autovacuum_max_workers without restarting
Previous Message Nathan Bossart 2025-01-07 16:58:40 Re: Small patch to use pqMsg_Query instead of `Q`