Mention max_prepared_transactions in PREPARE TRANSACTION reference page,

per Bruce's suggestion.

diff --git a/doc/src/sgml/ref/prepare_transaction.sgml b/doc/src/sgml/ref/prepare_transaction.sgml
index 277b9c53f19584ef31e35caddffc7336a78d0fb4..6230f04382548e2be7c41c21a65316f491d81883 100644 (file)
--- a/doc/src/sgml/ref/prepare_transaction.sgml
+++ b/doc/src/sgml/ref/prepare_transaction.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/prepare_transaction.sgml,v 1.2 2005/08/01 19:38:03 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/prepare_transaction.sgml,v 1.3 2005/08/30 01:37:38 tgl Exp $
 PostgreSQL documentation
 -->
 
@@ -117,6 +117,16 @@ PREPARE TRANSACTION <replaceable class="PARAMETER">transaction_id</replaceable>
    committed or rolled back as soon as an external transaction manager
    has verified that other databases are also prepared to commit.
   </para>
+
+  <para>
+   If you make any serious use of prepared transactions, you will probably
+   want to increase the value of <xref
+   linkend="guc-max-prepared-transactions">, as the default setting is
+   quite small (to avoid wasting resources for those who don't use it).
+   It is recommendable to make it at least equal to
+   <xref linkend="guc-max-connections">, so that every session can have
+   a prepared transaction pending.
+  </para>
  </refsect1>
 
  <refsect1 id="sql-prepare-transaction-examples">