Feedback-ID: ie3de48e3:Fastmail
Date: Mon, 21 Sep 2026 13:23:04 +0200
From: =?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@kurilemu.de>
To: Marcos Pegoraro <marcos@f10.com.br>
Cc: Fujii Masao <masao.fujii@gmail.com>,
	Nathan Bossart <nathandbossart@gmail.com>,
 pgsql-hackers <pgsql-hackers@postgresql.org>
Subject: Re: Correct some doc items due to the REPACK
Message-ID: <arEMuFA6byDGdzam@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: 
 <CAB-JLwZXekrNQNCG3CWpqNRssDmuyy1bXqYFA9ALr0y=bRiudQ@mail.gmail.com>
Archived-At: 
 <https://www.postgresql.org/message-id/arEMuFA6byDGdzam%40alvherre.pgsql>
Precedence: bulk

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)