diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml index b02440ecf53e49bb18983190c29f996e8a7b9cd0..e2418d33fefc5da45fbccba069e5ffd00f528724 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 }