Re: Correct some doc items due to the REPACK

From: Álvaro Herrera <alvherre(at)kurilemu(dot)de>
To: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
Cc: Fujii Masao <masao(dot)fujii(at)gmail(dot)com>, Nathan Bossart <nathandbossart(at)gmail(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Correct some doc items due to the REPACK
Date: 2026-09-21 11:23:04
Message-ID: arEMuFA6byDGdzam@alvherre.pgsql
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

For closure:

On 2026-Aug-26, Marcos Pegoraro wrote:

> monitoring.sgml
> The command that is running. One of <command>CLUSTER</command>,
> <command>REPACK</command>, or <command>VACUUM FULL</command>.
>
> should remove comma before or,

That with the commas is the style we use everywhere. These are called
"Oxford commas."

> maintenance.sgml
> get bloated to the point that a table-rewriting compaction operation such
> as <command>VACUUM FULL</command> or <command>REPACK</command> may be needed
>
> Did you forget CLUSTER here ?

I don't think mentioning CLUSTER improves things significantly here, as
that command's main purpose is not to remove bloat.

Thanks!

--
Álvaro Herrera Breisgau, Deutschland — https://www.EnterpriseDB.com/
"¿Qué importan los años? Lo que realmente importa es comprobar que
a fin de cuentas la mejor edad de la vida es estar vivo" (Mafalda)

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message solai v 2026-09-21 11:23:44 Re: [Patch] New pg_stat_tablespace view
Previous Message John Naylor 2026-09-21 11:11:41 Re: Support for 8-byte TOAST values, round two