diff --git a/jOOQ/src/main/java/org/jooq/DSLContext.java b/jOOQ/src/main/java/org/jooq/DSLContext.java
index d8c6577c29..45b1e4b34c 100644
--- a/jOOQ/src/main/java/org/jooq/DSLContext.java
+++ b/jOOQ/src/main/java/org/jooq/DSLContext.java
@@ -14795,13 +14795,20 @@ public interface DSLContext extends Scope {
     /**
      * Insert one record.
      * <p>
-     * This executes something like the following statement:
-     * <pre><code>INSERT INTO [table] … VALUES [record] </code></pre>
+     * This executes the following statement:
+     *
+     * <pre>
+     * <code>INSERT INTO [table] ([modified columns in record])
+     * VALUES ([modified values in record])</code>
+     * </pre>
      * <p>
-     * Unlike {@link UpdatableRecord#store()}, this does not change any of the
+     * Unlike {@link UpdatableRecord#insert()}, this does not change any of the
      * argument <code>record</code>'s internal "changed" flags, such that a
-     * subsequent call to {@link UpdatableRecord#store()} might lead to another
+     * subsequent call to {@link UpdatableRecord#insert()} might lead to another
      * <code>INSERT</code> statement being executed.
+     * <p>
+     * Also any optimistic locking related {@link Settings} do not apply for
+     * this method.
      *
      * @return The number of inserted records
      * @throws DataAccessException if something went wrong executing the query
@@ -14812,7 +14819,17 @@ public interface DSLContext extends Scope {
 
     /**
      * Update a table.
-     * <pre><code>UPDATE [table] SET [modified values in record] WHERE [record is supplied record] </code></pre>
+     * <p>
+     * This executes the following statement:
+     *
+     * <pre>
+     * <code>UPDATE [table]
+     * SET [modified values in record]
+     * WHERE [record is supplied record]</code>
+     * </pre>
+     * <p>
+     * Any optimistic locking related {@link Settings} do not apply for this
+     * method.
      *
      * @return The number of updated records
      * @throws DataAccessException if something went wrong executing the query
@@ -14823,7 +14840,17 @@ public interface DSLContext extends Scope {
 
     /**
      * Update a table.
-     * <pre><code>UPDATE [table] SET [modified values in record] WHERE [condition]</code></pre>
+     * <p>
+     * This executes the following statement:
+     *
+     * <pre>
+     * <code>UPDATE [table]
+     * SET [modified values in record]
+     * WHERE [condition]</code>
+     * </pre>
+     * <p>
+     * Any optimistic locking related {@link Settings} do not apply for this
+     * method.
      *
      * @return The number of updated records
      * @throws DataAccessException if something went wrong executing the query
@@ -14834,7 +14861,15 @@ public interface DSLContext extends Scope {
 
     /**
      * Delete a record from a table.
-     * <pre><code>DELETE FROM [table] WHERE [record is supplied record]</code></pre>
+     * <p>
+     * This executes the following statement:
+     *
+     * <pre>
+     * <code>DELETE FROM [table] WHERE [record is supplied record]</code>
+     * </pre>
+     * <p>
+     * Any optimistic locking related {@link Settings} do not apply for this
+     * method.
      *
      * @return The number of deleted records
      * @throws DataAccessException if something went wrong executing the query
@@ -14845,7 +14880,15 @@ public interface DSLContext extends Scope {
 
     /**
      * Delete a record from a table.
-     * <pre><code>DELETE FROM [table] WHERE [condition]</code></pre>
+     * <p>
+     * This executes the following statement:
+     *
+     * <pre>
+     * <code>DELETE FROM [table] WHERE [condition]</code>
+     * </pre>
+     * <p>
+     * Any optimistic locking related {@link Settings} do not apply for this
+     * method.
      *
      * @return The number of deleted records
      * @throws DataAccessException if something went wrong executing the query