Re: Overhauling "Routine Vacuuming" docs, particularly its handling of freezing

From: Peter Geoghegan <pg(at)bowt(dot)ie>
To: samay sharma <smilingsamay(at)gmail(dot)com>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Overhauling "Routine Vacuuming" docs, particularly its handling of freezing
Date: 2023-05-05 02:06:54
Message-ID: CAH2-WznyY5hUgdYJE8c5KoS2QbGXH9ggEuux-xY-gx5ETa4PAg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, May 4, 2023 at 3:18 PM samay sharma <smilingsamay(at)gmail(dot)com> wrote:
> What do you think about the term "Exhaustion"?

I'm really not sure.

Attached is v3, which (as with v1 and v2) comes with a prebuilt html
"Routine Vacuuming", for the convenience of reviewers.

v3 does have some changes based on your feedback (and feedback from
John), but overall v3 can be thought of as v2 with lots and lots of
additional copy-editing -- though still not enough, I'm sure.

v3 does add some (still incomplete) introductory remarks about the
intended audience and goals for "Routine Vacuuming". But most of the
changes are to the way the docs describe freezing and aggressive
VACUUM, which continued to be my focus for v3.

--
Peter Geoghegan

Attachment Content-Type Size
routine-vacuuming.html text/html 62.1 KB
v3-0001-Make-autovacuum-docs-into-a-sect1-of-its-own.patch application/octet-stream 18.2 KB
v3-0009-Overhaul-freezing-and-wraparound-docs.patch application/octet-stream 65.0 KB
v3-0008-Overhaul-Recovering-Disk-Space-vacuuming-docs.patch application/octet-stream 11.5 KB
v3-0007-Make-maintenance.sgml-more-autovacuum-orientated.patch application/octet-stream 8.6 KB
v3-0006-Merge-basic-vacuuming-sect2-into-sect1-introducti.patch application/octet-stream 6.2 KB
v3-0005-Move-Interpreting-XID-stamps-from-tuple-headers.patch application/octet-stream 12.9 KB
v3-0004-Reorder-routine-vacuuming-sections.patch application/octet-stream 16.2 KB
v3-0003-Normalize-maintenance.sgml-indentation.patch application/octet-stream 4.7 KB
v3-0002-Restructure-autovacuum-daemon-section.patch application/octet-stream 5.3 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message John Naylor 2023-05-05 02:44:57 Re: [PATCH] Clarify the behavior of the system when approaching XID wraparound
Previous Message Xing Guo 2023-05-05 01:40:32 Re: PL/Python: Fix return in the middle of PG_TRY() block.