Document recent changes in syntax, including examples.

diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml
index b02440ecf53e49bb18983190c29f996e8a7b9cd0..e2418d33fefc5da45fbccba069e5ffd00f528724 100644 (file)
--- a/doc/src/sgml/ref/set.sgml
+++ b/doc/src/sgml/ref/set.sgml
@@ -1,5 +1,5 @@
 
 
@@ -23,7 +23,7 @@ Postgres documentation
    1999-07-20
   
   
-SET variable { TO | = } { 'value' | DEFAULT }
+SET variable { TO | = } { value | 'value' | DEFAULT }
 SET TIME ZONE { 'timezone' | LOCAL | DEFAULT }
 SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
   
@@ -51,7 +51,9 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
       
        
    New value of parameter.  DEFAULT can be
-   used to specify resetting the parameter to its default value.
+   used to specify resetting the parameter to its default
+   value. Lists of strings are allowed, but more complex
+   constructs may need to be single or double quoted.
        
       
      
@@ -125,7 +127,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      European
      
       
-       use dd/mm/yyyy for numeric date representations.
+       use dd/mm/yyyy for numeric date representations.
       
      
     
@@ -133,7 +135,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      NonEuropean
      
       
-       use mm/dd/yyyy for numeric date representations.
+       use mm/dd/yyyy for numeric date representations.
       
      
     
@@ -141,7 +143,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      German
      
       
-       use dd.mm.yyyy for numeric date representations.
+       use dd.mm.yyyy for numeric date representations.
       
      
     
@@ -149,7 +151,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      US
      
       
-       same as 'NonEuropean'
+       same as NonEuropean
       
      
     
@@ -157,7 +159,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      DEFAULT
      
       
-       restores the default values ('US,Postgres')
+       restores the default values (US,Postgres)
       
      
     
@@ -237,7 +239,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
                
    
     
-     'PST8PDT'
+     PST8PDT
      
       
        set the timezone for California
@@ -245,7 +247,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      
     
     
-     'Portugal'
+     Portugal
      
       
        set time zone for Portugal.
@@ -755,7 +757,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
      DEFAULT
      
       
-       Equivalent to specifying SET KSQO='OFF'.
+       Equivalent to specifying SET KSQO=OFF.
       
      
     
@@ -885,13 +887,14 @@ WARN:  Bad value for variable (
    Usage
   
   
-   Set the style of date to ISO:
-   
+   Set the style of date to ISO (no quotes on the argument is required):
+
    
-SET DATESTYLE TO 'ISO';
+SET DATESTYLE TO ISO;
    
 
-   Enable GEQO for queries with 4 or more tables:
+   Enable GEQO for queries with 4 or more tables (note the use of
+   single quotes to handle the equal sign inside the value argument):
 
     
 SET GEQO = 'ON=4';
@@ -903,10 +906,12 @@ SET GEQO = 'ON=4';
 SET GEQO = DEFAULT;
    
 
-   Set the timezone for Berkeley, California:
+   Set the timezone for Berkeley, California, using double quotes to
+   preserve the uppercase
+   attributes of the time zone specifier:
 
  
-SET TIME ZONE 'PST8PDT';
+SET TIME ZONE "PST8PDT";
 SELECT CURRENT_TIMESTAMP AS today;
    
          today
@@ -914,7 +919,8 @@ SELECT CURRENT_TIMESTAMP AS today;
  1998-03-31 07:41:21-08
 
 
-Set the timezone for Italy:
+   Set the timezone for Italy (note the required single or double quotes to handle 
+   the special characters):
 
  
 SET TIME ZONE 'Europe/Rome';
@@ -959,7 +965,7 @@ SET TIME ZONE { interval_value_expression | LOCAL }