diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml
index b02440ecf5..e2418d33fe 100644
--- 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. 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 (
- 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 }