Move example of turning off synchronous_commit to a more logical place,

to wit in the description of that variable rather than some other one.

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 05996b491088328fa0579ddbbdfc1123e6e999e5..e910706a3133609e414fc63355f3543e96ec7209 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.163 2008/01/30 18:35:55 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.164 2008/02/02 23:29:12 tgl Exp $ -->
 
 <chapter Id="runtime-config">
   <title>Server Configuration</title>
@@ -1343,9 +1343,7 @@ SET ENABLE_SEQSCAN TO OFF;
         In many situations, turning off <xref linkend="guc-synchronous-commit">
         for noncritical transactions can provide much of the potential
         performance benefit of turning off <varname>fsync</varname>, without
-        the attendant risks of data corruption.  It can even be turned
-        off in a single multi-statement transaction using <command>SET
-        LOCAL synchronous_commit TO OFF;</>.
+        the attendant risks of data corruption.
        </para>
 
        <para>
@@ -1385,6 +1383,9 @@ SET ENABLE_SEQSCAN TO OFF;
         one transaction is determined by the setting in effect when it
         commits.  It is therefore possible, and useful, to have some
         transactions commit synchronously and others asynchronously.
+        For example, to make a single multi-statement transaction commit
+        asynchronously when the default is the opposite, issue <command>SET
+        LOCAL synchronous_commit TO OFF</> within the transaction.
        </para>
       </listitem>
      </varlistentry>