11<!--
2- $Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.33 2000/03/26 18:32:27 petere Exp $
2+ $Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.34 2000/03/31 03:20:17 thomas Exp $
33Postgres documentation
44-->
55
@@ -23,7 +23,7 @@ Postgres documentation
2323 <date>1999-07-20</date>
2424 </refsynopsisdivinfo>
2525 <synopsis>
26- SET <replaceable class="PARAMETER">variable</replaceable> { TO | = } { '<replaceable class="PARAMETER">value</replaceable>' | DEFAULT }
26+ SET <replaceable class="PARAMETER">variable</replaceable> { TO | = } {<replaceable class="PARAMETER">value</replaceable> | '<replaceable class="PARAMETER">value</replaceable>' | DEFAULT }
2727SET TIME ZONE { '<replaceable class="PARAMETER">timezone</replaceable>' | LOCAL | DEFAULT }
2828SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
2929 </synopsis>
@@ -51,7 +51,9 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
5151 <listitem>
5252 <para>
5353New value of parameter. <option>DEFAULT</option> can be
54- used to specify resetting the parameter to its default value.
54+ used to specify resetting the parameter to its default
55+ value. Lists of strings are allowed, but more complex
56+ constructs may need to be single or double quoted.
5557 </para>
5658 </listitem>
5759 </varlistentry>
@@ -125,39 +127,39 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
125127 <term>European</term>
126128 <listitem>
127129 <para>
128- use dd/mm/yyyy for numeric date representations.
130+ use<literal> dd/mm/yyyy</literal> for numeric date representations.
129131 </para>
130132 </listitem>
131133 </varlistentry>
132134 <varlistentry>
133135 <term>NonEuropean</term>
134136 <listitem>
135137 <para>
136- use mm/dd/yyyy for numeric date representations.
138+ use<literal> mm/dd/yyyy</literal> for numeric date representations.
137139 </para>
138140 </listitem>
139141 </varlistentry>
140142 <varlistentry>
141143 <term>German</term>
142144 <listitem>
143145 <para>
144- use dd.mm.yyyy for numeric date representations.
146+ use<literal> dd.mm.yyyy</literal> for numeric date representations.
145147 </para>
146148 </listitem>
147149 </varlistentry>
148150 <varlistentry>
149151 <term>US</term>
150152 <listitem>
151153 <para>
152- same as' NonEuropean'
154+ same as<literal> NonEuropean</literal>
153155 </para>
154156 </listitem>
155157 </varlistentry>
156158 <varlistentry>
157159 <term>DEFAULT</term>
158160 <listitem>
159161 <para>
160- restores the default values (' US,Postgres' )
162+ restores the default values (<literal> US,Postgres</literal> )
161163 </para>
162164 </listitem>
163165 </varlistentry>
@@ -237,15 +239,15 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
237239
238240<variablelist>
239241 <varlistentry>
240- <term>' PST8PDT' </term>
242+ <term>PST8PDT</term>
241243 <listitem>
242244 <para>
243245 set the timezone for California
244246 </para>
245247 </listitem>
246248 </varlistentry>
247249 <varlistentry>
248- <term>' Portugal' </term>
250+ <term>Portugal</term>
249251 <listitem>
250252 <para>
251253 set time zone for Portugal.
@@ -755,7 +757,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
755757 <term>DEFAULT</term>
756758 <listitem>
757759 <para>
758- Equivalent to specifying <command>SET KSQO=' OFF' </command>.
760+ Equivalent to specifying <command>SET KSQO=OFF</command>.
759761 </para>
760762 </listitem>
761763 </varlistentry>
@@ -885,13 +887,14 @@ WARN: Bad value for <replaceable class="parameter">variable</replaceable> (<rep
885887 Usage
886888 </title>
887889 <para>
888- Set the style of date to ISO:
889-
890+ Set the style of date to ISO (no quotes on the argument is required) :
891+
890892 <programlisting>
891- SET DATESTYLE TO' ISO' ;
893+ SET DATESTYLE TO ISO;
892894 </programlisting>
893895
894- Enable GEQO for queries with 4 or more tables:
896+ Enable GEQO for queries with 4 or more tables (note the use of
897+ single quotes to handle the equal sign inside the value argument):
895898
896899 <programlisting>
897900SET GEQO = 'ON=4';
@@ -903,18 +906,21 @@ SET GEQO = 'ON=4';
903906SET GEQO = DEFAULT;
904907 </programlisting>
905908
906- Set the timezone for Berkeley, California:
909+ Set the timezone for Berkeley, California, using double quotes to
910+ preserve the uppercase
911+ attributes of the time zone specifier:
907912
908913<programlisting>
909- SET TIME ZONE' PST8PDT' ;
914+ SET TIME ZONE" PST8PDT" ;
910915SELECT CURRENT_TIMESTAMP AS today;
911916
912917 today
913918------------------------
914919 1998-03-31 07:41:21-08
915920</programlisting>
916921
917- Set the timezone for Italy:
922+ Set the timezone for Italy (note the required single or double quotes to handle
923+ the special characters):
918924
919925<programlisting>
920926SET TIME ZONE 'Europe/Rome';
@@ -959,7 +965,7 @@ SET TIME ZONE { interval_value_expression | LOCAL }
959965
960966<!-- Keep this comment at the end of the file
961967Local variables:
962- mode: sgml
968+ mode:sgml
963969sgml-omittag:nil
964970sgml-shorttag:t
965971sgml-minimize-attributes:nil
@@ -969,7 +975,7 @@ sgml-indent-data:t
969975sgml-parent-document:nil
970976sgml-default-dtd-file:"../reference.ced"
971977sgml-exposed-tags:nil
972- sgml-local-catalogs:"/usr/lib/sgml/catalog"
978+ sgml-local-catalogs:( "/usr/lib/sgml/catalog")
973979sgml-local-ecat-files:nil
974980End:
975981-->