doc: clarify that storage parameter values are optional

In a few cases, the documented syntax specified storage parameter values
as required.

Reported-by: [email protected]
Discussion: https://postgr.es/m/159283163235.684.4482737698910467437@wrigleys.postgresql.org

Backpatch-through: 9.5

diff --git a/doc/src/sgml/ref/alter_index.sgml b/doc/src/sgml/ref/alter_index.sgml
index ad77b5743ac197911dc817395a3fb1a763b698ab..b3e282697de9a88982baa6e581298f2fe27646db 100644 (file)
--- a/doc/src/sgml/ref/alter_index.sgml
+++ b/doc/src/sgml/ref/alter_index.sgml
@@ -24,7 +24,7 @@ PostgreSQL documentation
 ALTER INDEX [ IF EXISTS ] name RENAME TO new_name
 ALTER INDEX [ IF EXISTS ] name SET TABLESPACE tablespace_name
 ALTER INDEX name DEPENDS ON EXTENSION extension_name
-ALTER INDEX [ IF EXISTS ] name SET ( storage_parameter = value [, ... ] )
+ALTER INDEX [ IF EXISTS ] name SET ( storage_parameter [= value] [, ... ] )
 ALTER INDEX [ IF EXISTS ] name RESET ( storage_parameter [, ... ] )
 ALTER INDEX ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ]
     SET TABLESPACE new_tablespace [ NOWAIT ]
@@ -84,7 +84,7 @@ ALTER INDEX ALL IN TABLESPACE name
    
 
    
-    SET ( storage_parameter = value [, ... ] )
+    SET ( storage_parameter [= value] [, ... ] )
     
      
       This form changes one or more index-method-specific storage parameters

diff --git a/doc/src/sgml/ref/alter_materialized_view.sgml b/doc/src/sgml/ref/alter_materialized_view.sgml
index b88f5ac00fb76e7bfe04d8d4a240ecce059a31f6..e27d38df19dd63ec2afdbb7211ceb33bb92fdde3 100644 (file)
--- a/doc/src/sgml/ref/alter_materialized_view.sgml
+++ b/doc/src/sgml/ref/alter_materialized_view.sgml
@@ -42,7 +42,7 @@ ALTER MATERIALIZED VIEW ALL IN TABLESPACE name
     ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
     CLUSTER ON index_name
     SET WITHOUT CLUSTER
-    SET ( storage_parameter = value [, ... ] )
+    SET ( storage_parameter [= value] [, ... ] )
     RESET ( storage_parameter [, ... ] )
     OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
 

diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index 6a5f93585dab960fd9e897406404d8522b9f92e2..946176213c0c00d0a8d69a1a4abe68a7182cc150 100644 (file)
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -76,7 +76,7 @@ ALTER TABLE [ IF EXISTS ] name
     SET WITHOUT OIDS
     SET TABLESPACE new_tablespace
     SET { LOGGED | UNLOGGED }
-    SET ( storage_parameter = value [, ... ] )
+    SET ( storage_parameter [= value] [, ... ] )
     RESET ( storage_parameter [, ... ] )
     INHERIT parent_table
     NO INHERIT parent_table
@@ -607,7 +607,7 @@ ALTER TABLE [ IF EXISTS ] name
    
 
    
-    SET ( storage_parameter = value [, ... ] )
+    SET ( storage_parameter [= value] [, ... ] )
     
      
       This form changes one or more storage parameters for the table.  See

diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml
index dc97ab69405f30ba3f6df76fae908c9cf9707865..dc4b645452a8d0e5171ae6b514ba2ec5545d7ddf 100644 (file)
--- a/doc/src/sgml/ref/create_index.sgml
+++ b/doc/src/sgml/ref/create_index.sgml
@@ -23,7 +23,7 @@ PostgreSQL documentation
 
 CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] name ] ON table_name [ USING method ]
     ( { column_name | ( expression ) } [ COLLATE collation ] [ opclass ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] [, ...] )
-    [ WITH ( storage_parameter = value [, ... ] ) ]
+    [ WITH ( storage_parameter [= value] [, ... ] ) ]
     [ TABLESPACE tablespace_name ]
     [ WHERE predicate ]