Doc: move unparenthesized syntaxes for a few commands.

Move documentation of the unparenthesized syntaxes for VACUUM,
ANALYZE, EXPLAIN, and CLUSTER to the "Compatibility" section of
their documentation to improve readability of the preferred,
parenthesized syntaxes.

Author: Melanie Plageman
Discussion: https://postgr.es/m/CAAKRu_bc5uHieG1976kGqJKxyWtyQt9yvktjsVX%2Bi7NOigDjOA%40mail.gmail.com

diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index aa3e9e1c5fe5b936bb42b4fc382a0192240e680f..1fba089265af2747da49f1d1697b753f0ff95490 100644 (file)
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -22,7 +22,6 @@ PostgreSQL documentation
  
 
 ANALYZE [ ( option [, ...] ) ] [ table_and_columns [, ...] ]
-ANALYZE [ VERBOSE ] [ table_and_columns [, ...] ]
 
 where option can be one of:
 
@@ -56,13 +55,6 @@ ANALYZE [ VERBOSE ] [ table_and_columns
    It is further possible to give a list of column names for a table,
    in which case only the statistics for those columns are collected.
   
-
-  
-   When the option list is surrounded by parentheses, the options can be
-   written in any order.  The parenthesized syntax was added in
-   PostgreSQL 11;  the unparenthesized syntax
-   is deprecated.
-  
  
 
  
@@ -339,6 +331,14 @@ ANALYZE [ VERBOSE ] [ table_and_columns
   
    There is no ANALYZE statement in the SQL standard.
   
+
+  
+   The following syntax was used before PostgreSQL
+   version 11 and is still supported:
+
+ANALYZE [ VERBOSE ] [ table_and_columns [, ...] ]
+
+  
  
 
  

diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml
index b6d5655c194359fa7317d171c15186f729975fe0..557a94cea78ad15b6055c34e7f070056b6b108d3 100644 (file)
--- a/doc/src/sgml/ref/cluster.sgml
+++ b/doc/src/sgml/ref/cluster.sgml
@@ -22,7 +22,6 @@ PostgreSQL documentation
  
 
 CLUSTER [ ( option [, ...] ) ] [ table_name [ USING index_name ] ]
-CLUSTER [ VERBOSE ] [ table_name [ USING index_name ] ]
 
 where option can be one of:
 
@@ -240,12 +239,19 @@ CLUSTER;
   
 
   
-   The syntax
+   The following syntax was used before PostgreSQL
+   17 and is still supported:
+
+CLUSTER [ VERBOSE ] [ table_name [ USING index_name ] ]
+
+  
+
+  
+   The following syntax was used before PostgreSQL
+   8.3 and is still supported:
 
 CLUSTER index_name ON table_name
 
-  is also supported for compatibility with pre-8.3 PostgreSQL
-  versions.
   
  
 

diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml
index 410490951b14b0e8f18600645292a5e4e9f72200..ae493c86d6c1b323a66f6099ce43d8ed1850a459 100644 (file)
--- a/doc/src/sgml/ref/explain.sgml
+++ b/doc/src/sgml/ref/explain.sgml
@@ -32,7 +32,6 @@ PostgreSQL documentation
  
 
 EXPLAIN [ ( option [, ...] ) ] statement
-EXPLAIN [ ANALYZE ] [ VERBOSE ] statement
 
 where option can be one of:
 
@@ -106,14 +105,6 @@ ROLLBACK;
 
    
   
-
-  
-   Only the ANALYZE and VERBOSE options
-   can be specified, and only in that order, without surrounding the option
-   list in parentheses.  Prior to PostgreSQL 9.0,
-   the unparenthesized syntax was the only one supported.  It is expected that
-   all new options will be supported only in the parenthesized syntax.
-  
  
 
  
@@ -529,6 +520,16 @@ EXPLAIN (GENERIC_PLAN)
   
    There is no EXPLAIN statement defined in the SQL standard.
   
+
+  
+   The following syntax was used before PostgreSQL
+   version 9.0 and is still supported:
+
+EXPLAIN [ ANALYZE ] [ VERBOSE ] statement
+
+   Note that in this syntax, the options must be specified in exactly the order
+   shown.
+  
  
 
  

diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index 65c03bf8299d8df6c4cede602c206694d0290a5a..90cde70c070332e5945966e76e58e7128a9ac971 100644 (file)
--- a/doc/src/sgml/ref/vacuum.sgml
+++ b/doc/src/sgml/ref/vacuum.sgml
@@ -22,7 +22,6 @@ PostgreSQL documentation
  
 
 VACUUM [ ( option [, ...] ) ] [ table_and_columns [, ...] ]
-VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns [, ...] ]
 
 where option can be one of:
 
@@ -90,15 +89,6 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ 
    much slower and requires an ACCESS EXCLUSIVE lock on
    each table while it is being processed.
   
-
-  
-   When the option list is surrounded by parentheses, the options can be
-   written in any order.  Without parentheses, options must be specified
-   in exactly the order shown above.
-   The parenthesized syntax was added in
-   PostgreSQL 9.0;  the unparenthesized
-   syntax is deprecated.
-  
  
 
  
@@ -525,6 +515,16 @@ VACUUM (VERBOSE, ANALYZE) onek;
   
    There is no VACUUM statement in the SQL standard.
   
+
+  
+   The following syntax was used before PostgreSQL
+   version 9.0 and is still supported:
+
+VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ table_and_columns [, ...] ]
+
+   Note that in this syntax, the options must be specified in exactly the order
+   shown.
+