doc: mention that SET TIME ZONE often needs to be quoted

Also mention that time zone abbreviations are not supported.

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

Backpatch-through: 10

diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml
index 5878c61f9b7944dd5564a99665794a5c6eddd627..5459b29525969f06ca2b2a4b9abca3cb848a3097 100644 (file)
--- a/doc/src/sgml/ref/set.sgml
+++ b/doc/src/sgml/ref/set.sgml
@@ -22,7 +22,7 @@ PostgreSQL documentation
  
 
 SET [ SESSION | LOCAL ] configuration_parameter { TO | = } { value | 'value' | DEFAULT }
-SET [ SESSION | LOCAL ] TIME ZONE { timezone | LOCAL | DEFAULT }
+SET [ SESSION | LOCAL ] TIME ZONE { value | 'value' | LOCAL | DEFAULT }
 
  
 
@@ -192,8 +192,8 @@ SELECT setseed(value);
     
      TIME ZONE
      
-      SET TIME ZONE value is an alias
-       for SET timezone TO value.  The
+      SET TIME ZONE 'value' is an alias
+       for SET timezone TO 'value'.  The
        syntax SET TIME ZONE allows special syntax
        for the time zone specification.  Here are examples of valid
        values:
@@ -254,7 +254,8 @@ SELECT setseed(value);
       
 
       
-       See  for more information
+       Time zone abbreviations are not supported by SET;
+       see  for more information
        about time zones.