Message-ID: <5400d859b612e1365a4bae3cf47fec1c3ed736ab.camel@cybertec.at>
Subject: Re: Clarify VACUUM FULL exclusion in total_vacuum_time docs
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Robert Treat <rob@xzilla.net>
Cc: Fujii Masao <masao.fujii@oss.nttdata.com>, "David G. Johnston"
	 <david.g.johnston@gmail.com>, "pgsql-docs@lists.postgresql.org"
	 <pgsql-docs@lists.postgresql.org>
Date: Tue, 15 Jul 2025 18:27:51 +0200
In-Reply-To: 
 <CAJSLCQ0Sh5YsOfdMXdTQQzTC2gVgVQdrkUekDvk_cvPj7p5YPA@mail.gmail.com>
References: <2ac375d1-591b-4f1b-a2af-f24335567866@oss.nttdata.com>
	 <CAKFQuwYgErraNuAUme-6dSwmwNSSStC8SL7560Qy2sAtUG5J+Q@mail.gmail.com>
	 <CABV9wwMs4g9nq-fKy=fFqU-rQUf6fiCqJg4_+MkqOnJE1n2TBA@mail.gmail.com>
	 <f58eb77f-0d8f-4f58-bed2-a100bd7e0814@oss.nttdata.com>
	 <CAJSLCQ3YPKaB7tQDyg8BbVuo80EGn_j6kycNGG3oZB59P8tgrg@mail.gmail.com>
	 <bb97b8d4-2f44-4b95-9b82-a54ecbce9e76@oss.nttdata.com>
	 <CAJSLCQ27T5utjOipbaqArGCPS1VT+2Uqx_g2NH3od_spHxkoig@mail.gmail.com>
	 <b1cfd248-6860-4a95-bb62-07009f5e486e@oss.nttdata.com>
	 <213ce4a8cc0e481229bdf2198f5c44285eb3e53a.camel@cybertec.at>
	 <CAJSLCQ0Sh5YsOfdMXdTQQzTC2gVgVQdrkUekDvk_cvPj7p5YPA@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
User-Agent: Evolution 3.56.2 (3.56.2-1.fc42) 
MIME-Version: 1.0
Archived-At: 
 <https://www.postgresql.org/message-id/5400d859b612e1365a4bae3cf47fec1c3ed736ab.camel%40cybertec.at>
Precedence: bulk

On Tue, 2025-07-15 at 10:27 -0400, Robert Treat wrote:
> On the other hand, reading the VACUUM reference page, I get the
> > feeling that the new syntax with parentheses should be favored.
> > After all, the old syntax doesn't support any of the recently
> > added options and restricts the option order.
> >=20
> > So perhaps we should start propagating the parentheses more, and
> > the documentation is the perfect place to do that.
>=20
> That might make sense, but how far we want to take it in the first go
> around seems like a discussion that is best put forth in a separate
> thread / patch.

Makes sense, and I have no objection to the patch as it is.

Yours,
Laurenz Albe