svn commit: r1308722 - in /httpd/httpd/branches/2.2.x/docs/manual/mod: mod_dbd.html.en mod_dbd.xml

[hu...@apache.org]

Author: humbedooh
Date: Tue Apr  3 06:49:36 2012
New Revision: 1308722

URL: http://svn.apache.org/viewvc?rev=1308722&view=rev
Log:
Backport r1308718 to 2.2 and rebuild.

Modified:
    httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.html.en
    httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.html.en?rev=1308722&r1=1308721&r2=1308722&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.html.en Tue Apr  3 06:49:36 2012
@@ -130,6 +130,13 @@ APR_DECLARE_OPTIONAL_FN(void, ap_dbd_pre
     <p>It is up to dbd user modules to use the prepared statements
     and document what statements can be specified in httpd.conf,
     or to provide their own directives and use <code>ap_dbd_prepare</code>.</p>
+	<div class="warning"><h3>Caveat</h3>
+	When using prepared statements with a MySQL database, it is preferred to set
+	<code>reconnect</code> to 0 in the connection string as to avoid errors that
+	arise from the MySQL client reconnecting without properly resetting the
+	prepared statements. If set to 1, any broken connections will be attempted
+	fixed, but as mod_dbd is not informed, the prepared statements will be invalidated.
+	</div>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="security" id="security">SECURITY WARNING</a></h2>

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.xml?rev=1308722&r1=1308721&r2=1308722&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_dbd.xml Tue Apr  3 06:49:36 2012
@@ -112,6 +112,13 @@ APR_DECLARE_OPTIONAL_FN(void, ap_dbd_pre
     <p>It is up to dbd user modules to use the prepared statements
     and document what statements can be specified in httpd.conf,
     or to provide their own directives and use <code>ap_dbd_prepare</code>.</p>
+	<note type="warning"><title>Caveat</title>
+	When using prepared statements with a MySQL database, it is preferred to set
+	<code>reconnect</code> to 0 in the connection string as to avoid errors that
+	arise from the MySQL client reconnecting without properly resetting the
+	prepared statements. If set to 1, any broken connections will be attempted
+	fixed, but as mod_dbd is not informed, the prepared statements will be invalidated.
+	</note>
 </section>
 
 <section id="security">