X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fref-transaction.xml;h=5731c466da3783a0589683effe72f3d952c0d19c;hb=b50166ae0ba2bc09a9094c0e675ec92010b7293e;hp=fea95176d1e3f1547d8bea8663e959962dc54088;hpb=04df7e672f08154fbc213236dfb2d2dd2023e802;p=clsql.git

diff --git a/doc/ref-transaction.xml b/doc/ref-transaction.xml
index fea9517..5731c46 100644
--- a/doc/ref-transaction.xml
+++ b/doc/ref-transaction.xml
@@ -16,6 +16,16 @@
       transaction blocks, committing or rolling back changes made and
       controlling autocommit behaviour.
     </para>
+    <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>
 
   <refentry id="start-transaction">
@@ -23,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>
@@ -124,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>
@@ -228,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>
@@ -331,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>
@@ -423,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>
@@ -524,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>
@@ -624,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>
@@ -725,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>
@@ -745,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. 
@@ -759,7 +770,6 @@
             <para>The result of executing <parameter>body</parameter>.</para>
           </listitem>
         </varlistentry>
-        </varlistentry>
       </variablelist>
     </refsect1>
     <refsect1>