I just noticed, it does describe that it takes an exclusive access lock, so that part is covered. (Maybe add „This is not an „ONLINE“ operation“ as this use a more common terminology?)

Thanks for your work
Bernd
 

Von: PG Doc comments form <noreply@postgresql.org>
Gesendet: Freitag, Juni 7, 2024 5:47 AM
An: pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
Cc: ecki@zusammenkunft.net <ecki@zusammenkunft.net>
Betreff: CLUSTER details
 
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/16/sql-cluster.html
Description:

The cloister command should describe how or deals with free pages (I.e. are
released) and what it’s lock model is (i.e. that it is (not yet?) an online
operation. It should probably also mention if it has intermittent additional
disk space requirements (or not).