Complete markup for docbook2man support.

Fix synopsis info thanks to Yves.Martin@ensimag.imag.fr.

doc/src/sgml/ref/set.sgml

@@ -20,7 +20,7 @@
   <synopsis>
 SET <replaceable class="PARAMETER">variable</replaceable> { TO | = } { '<replaceable class="PARAMETER">value</replaceable>' | DEFAULT }
 SET TIME ZONE { '<replaceable class="PARAMETER">timezone</replaceable>' | LOCAL | DEFAULT }
-SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZED }
+SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
   </synopsis>
 
   <refsect2 id="R2-SQL-SET-1">
@@ -34,9 +34,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZED }
 		
     <variablelist>
      <varlistentry>
-      <term>
+      <term><replaceable class="PARAMETER">variable</replaceable></term>
-<replaceable class="PARAMETER">variable</replaceable>
-      </term>
       <listitem>
        <para>
 	Settable global parameter.
@@ -44,9 +42,7 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZED }
       </listitem>
      </varlistentry>
      <varlistentry>
-      <term>
+      <term><replaceable class="PARAMETER">value</replaceable></term>
-<replaceable class="PARAMETER">value</replaceable>
-      </term>
       <listitem>
        <para>
 	New value of parameter.
@@ -61,18 +57,14 @@ SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZED }
 		
     <variablelist>
      <varlistentry>
-      <term>
+      <term>CLIENT_ENCODING | NAMES</term>
-CLIENT_ENCODING | NAMES
-      </term>
       <listitem>
        <para>
 	Sets the multi-byte client encoding. Parameters are:
 	
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term><replaceable class="parameter">value</replaceable></term>
-<replaceable class="parameter">value</replaceable>
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the multi-byte client encoding to
@@ -83,9 +75,7 @@ CLIENT_ENCODING | NAMES
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the multi-byte client encoding to the default value.
@@ -102,9 +92,7 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>DateStyle</term>
-DateStyle
-      </term>
       <listitem>
        <para>
 	Set the date/time representation style. Affects the output format,
@@ -112,9 +100,7 @@ DateStyle
 
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term>ISO</term>
-ISO
-	  </term>
 	  <listitem>
 	   <para>
 	    use ISO 8601-style dates and times
@@ -122,9 +108,7 @@ ISO
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>SQL</term>
-SQL
-	  </term>
 	  <listitem>
 	   <para>
 	    use Oracle/Ingres-style dates and times
@@ -132,9 +116,7 @@ SQL
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>Postgres</term>
-Postgres
-	  </term>
 	  <listitem>
 	   <para>
 	    use traditional <productname>Postgres</productname> format
@@ -142,9 +124,7 @@ Postgres
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>European</term>
-European
-	  </term>
 	  <listitem>
 	   <para>
 	    use dd/mm/yyyy for numeric date representations.
@@ -152,9 +132,7 @@ European
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>NonEuropean</term>
-NonEuropean
-	  </term>
 	  <listitem>
 	   <para>
 	    use mm/dd/yyyy for numeric date representations.
@@ -162,9 +140,7 @@ NonEuropean
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>German</term>
-German
-	  </term>
 	  <listitem>
 	   <para>
 	    use dd.mm.yyyy for numeric date representations.
@@ -172,9 +148,7 @@ German
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>US</term>
-US
-	  </term>
 	  <listitem>
 	   <para>
 	    same as 'NonEuropean'
@@ -182,9 +156,7 @@ US
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-default
-	  </term>
 	  <listitem>
 	   <para>
 	    restores the default values ('US,Postgres')
@@ -227,18 +199,14 @@ default
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>SERVER_ENCODING</term>
-SERVER_ENCODING
-      </term>
       <listitem>
        <para>
 	Sets the multi-byte server encoding
 	
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term><replaceable class="parameter">value</replaceable></term>
-<replaceable class="parameter">value</replaceable>
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the multi-byte server encoding.
@@ -247,9 +215,7 @@ SERVER_ENCODING
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the multi-byte server encoding.
@@ -265,9 +231,7 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>TIMEZONE</term>
-TIMEZONE
-      </term>
       <listitem>
        <para>
 	The possible values for timezone depends on your operating
@@ -279,9 +243,7 @@ TIMEZONE
 				
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term>'PST8PDT'</term>
-'PST8PDT'
-	  </term>
 	  <listitem>
 	   <para>
 	    set the timezone for California
@@ -289,9 +251,7 @@ TIMEZONE
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>'Portugal'</term>
-'Portugal'
-	  </term>
 	  <listitem>
 	   <para>
 	    set time zone for Portugal.
@@ -299,9 +259,7 @@ TIMEZONE
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>'Europe/Rome'</term>
-'Europe/Rome'
-	  </term>
 	  <listitem>
 	   <para>
 	    set time zone for Italy.
@@ -309,9 +267,7 @@ TIMEZONE
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    set time zone to your local timezone
@@ -339,18 +295,14 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>TRANSACTION ISOLATION LEVEL</term>
-TRANSACTION ISOLATION LEVEL
-      </term>
       <listitem>
        <para>
 	Sets the isolation level for the current transaction.
 	
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term>READ COMMITTED</term>
-READ COMMITTED
-	  </term>
 	  <listitem>
 	   <para>
 	    The current transaction queries read only rows committed
@@ -367,9 +319,7 @@ READ COMMITTED
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>SERIALIZABLE</term>
-SERIALIZABLE
-	  </term>
 	  <listitem>
 	   <para>
 	    The current transaction queries read only rows committed
@@ -394,18 +344,14 @@ SERIALIZABLE
     
     <variablelist>
      <varlistentry>
-      <term>
+      <term>COST_HEAP</term>
-COST_HEAP
-      </term>
       <listitem>
        <para>
 	Sets the default cost of a heap scan for use by the optimizer.
 	
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term><replaceable class="parameter">float4</replaceable></term>
-<replaceable class="parameter">float4</replaceable>
-	  </term>
 	  <listitem>
 	   <para>
 	    Set the cost of a heap scan to the specified floating point value.
@@ -414,9 +360,7 @@ COST_HEAP
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the cost of a heap scan to the default value.
@@ -433,18 +377,14 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>COST_INDEX</term>
-COST_INDEX
-      </term>
       <listitem>
        <para>
 	Sets the default cost of an index scan for use by the optimizer.
 
 	<variablelist>     
 	 <varlistentry>
-	  <term>
+	  <term><replaceable class="parameter">float4</replaceable></term>
-<replaceable class="parameter">float4</replaceable>
-	  </term>
 	  <listitem>
 	   <para>
 	    Set the cost of an index scan to the specified floating point value.
@@ -453,9 +393,7 @@ COST_INDEX
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Sets the cost of an index scan to the default value.
@@ -473,18 +411,14 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>GEQO</term>
-GEQO
-      </term>
       <listitem>
        <para>
 	Sets the threshold for using the genetic optimizer algorithm.
-       
+
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term>ON</term>
-ON
-	  </term>
 	  <listitem>
 	   <para>
 	    enables the genetic optimizer algorithm
@@ -492,10 +426,9 @@ ON
 	   </para>
 	  </listitem>
 	 </varlistentry>
+
 	 <varlistentry>
-	  <term>
+	  <term>ON=<replaceable class="parameter">#</replaceable></term>
-ON=<replaceable class="parameter">#</replaceable>
-	  </term>
 	  <listitem>
 	   <para>
 	    Takes an integer argument to enable the genetic optimizer algorithm
@@ -504,10 +437,9 @@ ON=<replaceable class="parameter">#</replaceable>
 	   </para>
 	  </listitem>
 	 </varlistentry>
+
 	 <varlistentry>
-	  <term>
+	  <term>OFF</term>
-OFF
-	  </term>
 	  <listitem>
 	   <para>
 	    disables the genetic optimizer algorithm.
@@ -515,9 +447,7 @@ OFF
 	  </listitem>
 	 </varlistentry>
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Equivalent to specifying <command>SET GEQO='ON'</command>
@@ -546,9 +476,7 @@ DEFAULT
      </varlistentry>
 
      <varlistentry>
-      <term>
+      <term>KSQO</term>
-KSQO
-      </term>
       <listitem>
        <para>
 	<firstterm>Key Set Query Optimizer</firstterm> forces the query optimizer
@@ -557,9 +485,7 @@ KSQO
        
 	<variablelist>
 	 <varlistentry>
-	  <term>
+	  <term>ON</term>
-ON
-	  </term>
 	  <listitem>
 	   <para>
 	    enables this optimization.
@@ -568,9 +494,7 @@ ON
 	 </varlistentry>
 	
 	 <varlistentry>
-	  <term>
+	  <term>OFF</term>
-OFF
-	  </term>
 	  <listitem>
 	   <para>
 	    disables this optimization.
@@ -579,9 +503,7 @@ OFF
 	 </varlistentry>
 	 
 	 <varlistentry>
-	  <term>
+	  <term>DEFAULT</term>
-DEFAULT
-	  </term>
 	  <listitem>
 	   <para>
 	    Equivalent to specifying <command>SET KSQO='OFF'</command>.
@@ -618,9 +540,9 @@ DEFAULT
     
     <variablelist>
      <varlistentry>
-      <term>
+      <term><computeroutput>
-<returnvalue>SET VARIABLE</returnvalue>
+SET VARIABLE
-      </term>
+       </computeroutput></term>
       <listitem>
        <para>
 	Message returned if successfully.
@@ -629,9 +551,9 @@ DEFAULT
      </varlistentry>
      
      <varlistentry>
-      <term>
+      <term><computeroutput>
-<returnvalue>WARN:  Bad value for <replaceable class="parameter">variable</replaceable> (<replaceable class="parameter">value</replaceable>)</returnvalue>
+WARN:  Bad value for <replaceable class="parameter">variable</replaceable> (<replaceable class="parameter">value</replaceable>)
-      </term>
+       </computeroutput></term>
       <listitem>
        <para>
 	If the command fails to set the specified variable.
@@ -697,26 +619,26 @@ DEFAULT
    Set the style of date to ISO:
    
    <programlisting>
-   SET DATESTYLE TO 'ISO';
+SET DATESTYLE TO 'ISO';
    </programlisting>
 
    Enable GEQO for queries with 4 or more tables:
 
    <programlisting> 
-   SET GEQO ON=4;
+SET GEQO ON=4;
    </programlisting>
 
    Set GEQO to default:
 
    <programlisting> 
-   SET GEQO = DEFAULT;
+SET GEQO = DEFAULT;
    </programlisting>
 
    Set the timezone for Berkeley, California:
 
    <programlisting> 
-   SET TIME ZONE 'PST8PDT';
+SET TIME ZONE 'PST8PDT';
-   SELECT CURRENT_TIMESTAMP AS today;
+SELECT CURRENT_TIMESTAMP AS today;
    
    today
    ----------------------
@@ -726,8 +648,8 @@ DEFAULT
    Set the timezone for Italy:
 
    <programlisting> 
-   SET TIME ZONE 'Europe/Rome';
+SET TIME ZONE 'Europe/Rome';
-   SELECT CURRENT_TIMESTAMP AS today;
+SELECT CURRENT_TIMESTAMP AS today;
    
    today
    ----------------------
@@ -751,17 +673,18 @@ DEFAULT
     SQL92
    </title>
    <para>
-    There is no
+    There is no general
     <command>SET <replaceable class="parameter">variable</replaceable></command>
-    in <acronym>SQL92</acronym> (except for SET TRANSACTION ISOLATION LEVEL).
+    in <acronym>SQL92</acronym> (with the exception of
-    
+    <command>SET TRANSACTION ISOLATION LEVEL</command>).
+
     The <acronym>SQL92</acronym> syntax for <command>SET TIME ZONE</command>
     is slightly different,
     allowing only a single integer value for time zone specification:
     
-    <programlisting>
+    <synopsis>
-     SET TIME ZONE { interval_value_expression | LOCAL }
+SET TIME ZONE { interval_value_expression | LOCAL }
-    </programlisting>
+    </synopsis>
    </para>
   </refsect2>
  </refsect1>
@@ -779,7 +702,7 @@ sgml-indent-data:t
 sgml-parent-document:nil
 sgml-default-dtd-file:"../reference.ced"
 sgml-exposed-tags:nil
-sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
+sgml-local-catalogs:"/usr/lib/sgml/catalog"
 sgml-local-ecat-files:nil
 End:
 -->