diff --git a/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/MySQLDictionary.java b/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/MySQLDictionary.java
index 1dfcc6613..412d2dad5 100644
--- a/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/MySQLDictionary.java
+++ b/openjpa-jdbc/src/main/java/org/apache/openjpa/jdbc/sql/MySQLDictionary.java
@@ -46,8 +46,8 @@ public class MySQLDictionary
public String tableType = "innodb";
/**
- * Whether to use clobs. Some older versions of MySQL do not handle
- * clobs properly so we default to false here.
+ * Whether to use clobs; defaults to true. Set this to false if you have an
+ * old version of MySQL which does not handle clobs properly.
*/
public boolean useClobs = true;
diff --git a/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml b/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml
index 76d2c193f..b9a1e6ef0 100644
--- a/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml
+++ b/openjpa-project/src/doc/manual/ref_guide_dbsetup.xml
@@ -3159,12 +3159,14 @@ properties:
DriverDeserializesBlobs
-DriverDeserializesBlobs: Many MySQL drivers automatically
-deserialize BLOBs on calls to ResultSet.getObject. The
+DriverDeserializesBlobs: Many older MySQL drivers
+automatically deserialize BLOBs on calls to
+ResultSet.getObject. The
MySQLDictionary overrides the standard
-DBDictionary.getBlobObject method to take this into account. If
-your driver does not deserialize automatically, set this property to
-false.
+DBDictionary.getBlobObject method to take this into account.
+Defaults to true if driver version is less than 5.0,
+false otherwise. If your driver deserializes
+automatically, you may want to set this property to true.
@@ -3191,9 +3193,9 @@ Defaults to "innodb".
UseClobs
-UseClobs: Some older versions of MySQL do not handle clobs
-correctly. To enable clob functionality, set this to true.
-Defaults to false.
+UseClobs: Some older versions of MySQL do not handle CLOBs
+correctly. To disable CLOB functionality, set this to false.
+Defaults to true.