From cc367951a924855b910d0007934e0ef0cc27940a Mon Sep 17 00:00:00 2001
From: Tom Lane <tgl@sss.pgh.pa.us>
Date: Tue, 30 Aug 2005 01:37:38 +0000
Subject: [PATCH] Mention max_prepared_transactions in PREPARE TRANSACTION
 reference page, per Bruce's suggestion.

---
 doc/src/sgml/ref/prepare_transaction.sgml | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/ref/prepare_transaction.sgml b/doc/src/sgml/ref/prepare_transaction.sgml
index 277b9c53f1..6230f04382 100644
--- 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">
-- 
2.11.0