From: Jeff Davis <jdavis@postgresql.org>
Date: Thu, 26 Jan 2023 04:23:32 +0000 (-0800)
Subject: Clarify documentation for CLUSTER on partitioned tables.
X-Git-Tag: REL_16_BETA1~835
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8b5f36bb6c16c030561d83b74b8c3270dbf48b68;p=thirdparty%2Fpostgresql.git

Clarify documentation for CLUSTER on partitioned tables.

Author: Nathan Bossart
Discussion: https://postgr.es/m/20230114224000.GA2505377@nathanxps13
---

diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml
index b9f2acb1dec..29f0f1fd901 100644
--- a/doc/src/sgml/ref/cluster.sgml
+++ b/doc/src/sgml/ref/cluster.sgml
@@ -67,7 +67,8 @@ CLUSTER [VERBOSE]
   </para>
 
   <para>
-   <command>CLUSTER</command> without any parameter reclusters all the
+   <command>CLUSTER</command> without a
+   <replaceable class="parameter">table_name</replaceable> reclusters all the
    previously-clustered tables in the current database that the calling user
    has privileges for.  This form of <command>CLUSTER</command> cannot be
    executed inside a transaction block.
@@ -211,7 +212,8 @@ CLUSTER [VERBOSE]
    <para>
     Clustering a partitioned table clusters each of its partitions using the
     partition of the specified partitioned index.  When clustering a partitioned
-    table, the index may not be omitted.
+    table, the index may not be omitted.  <command>CLUSTER</command> on a
+    partitioned table cannot be executed inside a transaction block.
    </para>
 
  </refsect1>