r11229: new doc

[clsql.git] / doc / ref-transaction.xml

diff --git a/doc/ref-transaction.xml b/doc/ref-transaction.xml
index cbb60c2a6c2c101fbe8b18edda91008750ea2771..5731c466da3783a0589683effe72f3d952c0d19c 100644 (file)
--- a/doc/ref-transaction.xml
+++ b/doc/ref-transaction.xml
@@ -16,13 +16,15 @@
       transaction blocks, committing or rolling back changes made and
       controlling autocommit behaviour.
     </para>
-    <note> 
+    <note>
+      <para>
       In contrast to &commonsql;, &clsql;, by default, starts in
       transaction AUTOCOMMIT mode (see <link
       linkend="set-autocommit"><function>set-autocommit</function></link>).
       To begin a transaction in autocommit mode, <link
       linkend="start-transaction"><function>start-transaction</function></link>
       has to be called explicitly.
+      </para>
     </note> 
   </partintro>
 
@@ -31,7 +33,7 @@
       <refentrytitle>START-TRANSACTION</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">START-TRANSACTION</emphasis></refname>
+      <refname>START-TRANSACTION</refname>
       <refpurpose>Open a transaction block.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -132,7 +134,7 @@
       <refentrytitle>COMMIT</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">COMMIT</emphasis></refname>
+      <refname>COMMIT</refname>
       <refpurpose>Commit modifications made in the current transaction.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -236,7 +238,7 @@
       <refentrytitle>ROLLBACK</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">ROLLBACK</emphasis></refname>
+      <refname>ROLLBACK</refname>
       <refpurpose>Roll back modifications made in the current transaction.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -339,7 +341,7 @@
       <refentrytitle>IN-TRANSACTION-P</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">IN-TRANSACTION-P</emphasis></refname>
+      <refname>IN-TRANSACTION-P</refname>
       <refpurpose>A predicate for testing whether a transaction is currently in progress.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -431,7 +433,7 @@
       <refentrytitle>ADD-TRANSACTION-COMMIT-HOOK</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">ADD-TRANSACTION-COMMIT-HOOK</emphasis></refname>
+      <refname>ADD-TRANSACTION-COMMIT-HOOK</refname>
       <refpurpose>Specify hooks to be run when committing changes.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -532,7 +534,7 @@
       <refentrytitle>ADD-TRANSACTION-ROLLBACK-HOOK</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">ADD-TRANSACTION-ROLLBACK-HOOK</emphasis></refname>
+      <refname>ADD-TRANSACTION-ROLLBACK-HOOK</refname>
       <refpurpose>Specify hooks to be run when rolling back changes.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -632,7 +634,7 @@
       <refentrytitle>SET-AUTOCOMMIT</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Function</emphasis> <emphasis role="bold">SET-AUTOCOMMIT</emphasis></refname>
+      <refname>SET-AUTOCOMMIT</refname>
       <refpurpose>Turn on or off autocommit for a database.</refpurpose>
       <refclass>Function</refclass>
     </refnamediv>
@@ -733,7 +735,7 @@
       <refentrytitle>WITH-TRANSACTION</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname><emphasis>Macro</emphasis> <emphasis role="bold">WITH-TRANSACTION</emphasis></refname>
+      <refname>WITH-TRANSACTION</refname>
       <refpurpose>Execute a body of code within a transaction.</refpurpose>
       <refclass>Macro</refclass>
     </refnamediv>
@@ -753,8 +755,9 @@
             object</glossterm>. This will default to the value
             of <symbol>*default-database*</symbol>.</para>
           </listitem>
-<varlistentry>
-          <term><parameter>body</parameter></term>
+       </varlistentry>
+       <varlistentry>
+         <term><parameter>body</parameter></term>
           <listitem>
             <para>
               A body of Lisp code. 
@@ -767,7 +770,6 @@
             <para>The result of executing <parameter>body</parameter>.</para>
           </listitem>
         </varlistentry>
-        </varlistentry>
       </variablelist>
     </refsect1>
     <refsect1>