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">
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
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.
<para>The result of executing <parameter>body</parameter>.</para>
</listitem>
</varlistentry>
- </varlistentry>
</variablelist>
</refsect1>
<refsect1>