Index: doc/pgjdbc.xml
===================================================================
RCS file: /cvsroot/jdbc/pgjdbc/doc/pgjdbc.xml,v
retrieving revision 1.37
diff -u -r1.37 pgjdbc.xml
--- doc/pgjdbc.xml	3 Feb 2009 04:37:45 -0000	1.37
+++ doc/pgjdbc.xml	10 Mar 2009 09:11:04 -0000
@@ -2414,8 +2414,12 @@
      This avoids the cost of replanning the query every time, but also
      means that the planner cannot take advantage of the particular
      parameter values used in a particular execution of the query.
-     You should be cautious about enabling the use of server side prepared
-     statements globally.
+     This should be used carefully, as it may induce queries executed
+     orders of magnitude slower, for example when the planner opts for
+     a sequential scan in the prepared statement, and then the query
+     is executed with parameters which would highly benefit from an
+     index scan. You should be cautious about enabling the use of
+     server side prepared statements globally.
     </para>
    </note>