Better javadoc

Sylvain Lebresne · Sylvain Lebresne · commit 9fbf046c26fc · 2014-02-25T17:25:57.000+01:00
diff --git a/driver-core/src/main/java/com/datastax/driver/core/Session.java b/driver-core/src/main/java/com/datastax/driver/core/Session.java
@@ -153,11 +153,10 @@ public interface Session {
      * </pre>
      * the final execution will be performed with Quorum consistency.
      * <p>
-     * Please note however that if the same CQL statement is prepared more than
-     * once, all calls to this method will return the same {@code PreparedStatement}
-     * object (which imply that this unique {@code PreparedStatement} object will
-     * inherit the query properties of the last statement for which this method
-     * has been called).
+     * Please note that if the same CQL statement is prepared more than once, all
+     * calls to this method will return the same {@code PreparedStatement} object
+     * but the method will still apply the properties of the prepared
+     * {@code Statement} to this object.
      *
      * @param statement the statement to prepare
      * @return the prepared statement corresponding to {@code statement}.
@@ -186,11 +185,10 @@ public interface Session {
      * but with the additional effect that the resulting {@code
      * PreparedStamenent} will inherit the query properties set on {@code statement}.
      * <p>
-     * Please note however that if the same CQL statement is prepared more than
-     * once, all calls to this method will return the same {@code PreparedStatement}
-     * object (which imply that this unique {@code PreparedStatement} object will
-     * inherit the query properties of the last statement for which this method
-     * has been called).
+     * Please note that if the same CQL statement is prepared more than once, all
+     * calls to this method will return the same {@code PreparedStatement} object
+     * but the method will still apply the properties of the prepared
+     * {@code Statement} to this object.
      *
      * @param statement the statement to prepare
      * @return a future on the prepared statement corresponding to {@code statement}.
