diff --git a/jOOQ/src/main/java/org/jooq/DSLContext.java b/jOOQ/src/main/java/org/jooq/DSLContext.java
index 6438cc2a41..91870f24de 100644
--- a/jOOQ/src/main/java/org/jooq/DSLContext.java
+++ b/jOOQ/src/main/java/org/jooq/DSLContext.java
@@ -6950,7 +6950,8 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of INSERT and
- * UPDATE queries in batch mode (with bind values).
+ * UPDATE queries in batch mode (with bind values) according to
+ * {@link UpdatableRecord#store()} semantics.
*
* This batch operation can be executed in two modes: *
@@ -6987,6 +6988,7 @@ public interface DSLContext extends Scope , AutoCloseable {
* the order of records is preserved entirely, and jOOQ can guarantee that
* only a single batch statement is serialised to the database.
*
+ * @see UpdatableRecord#store()
* @see Statement#executeBatch()
*/
@Support
@@ -6994,9 +6996,11 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of INSERT and
- * UPDATE queries in batch mode (with bind values).
+ * UPDATE queries in batch mode (with bind values) according to
+ * {@link UpdatableRecord#store()} semantics.
*
* @see #batchStore(UpdatableRecord...)
+ * @see UpdatableRecord#store()
* @see Statement#executeBatch()
*/
@Support
@@ -7004,9 +7008,11 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of INSERT queries
- * in batch mode (with bind values).
+ * in batch mode (with bind values) according to
+ * {@link TableRecord#insert()} semantics.
*
* @see #batchStore(UpdatableRecord...)
+ * @see TableRecord#insert()
* @see Statement#executeBatch()
*/
@Support
@@ -7014,7 +7020,8 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of INSERT queries
- * in batch mode (with bind values).
+ * in batch mode (with bind values) according to
+ * {@link TableRecord#insert()} semantics.
*
* @see #batchStore(UpdatableRecord...)
* @see Statement#executeBatch()
@@ -7024,9 +7031,11 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of UPDATE queries
- * in batch mode (with bind values).
+ * in batch mode (with bind values) according to
+ * {@link UpdatableRecord#update()} semantics.
*
* @see #batchStore(UpdatableRecord...)
+ * @see UpdatableRecord#update()
* @see Statement#executeBatch()
*/
@Support
@@ -7034,9 +7043,11 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of UPDATE queries
- * in batch mode (with bind values).
+ * in batch mode (with bind values) according to
+ * {@link UpdatableRecord#update()} semantics.
*
* @see #batchStore(UpdatableRecord...)
+ * @see UpdatableRecord#update()
* @see Statement#executeBatch()
*/
@Support
@@ -7044,7 +7055,8 @@ public interface DSLContext extends Scope , AutoCloseable {
/**
* Create a batch statement to execute a set of DELETE queries
- * in batch mode (with bind values).
+ * in batch mode (with bind values) according to
+ * {@link UpdatableRecord#delete()} sematics.
*
* This batch operation can be executed in two modes: *
@@ -7081,16 +7093,19 @@ public interface DSLContext extends Scope , AutoCloseable {
* the order of records is preserved entirely, and jOOQ can guarantee that
* only a single batch statement is serialised to the database.
*
+ * @see UpdatableRecord#delete()
* @see Statement#executeBatch()
*/
@Support
Batch batchDelete(UpdatableRecord>... records);
/**
- * Create a batch statement to execute a set of DELETE in batch
- * mode (with bind values).
+ * Create a batch statement to execute a set of DELETE queries
+ * in batch mode (with bind values) according to
+ * {@link UpdatableRecord#delete()} sematics.
*
* @see #batchDelete(UpdatableRecord...)
+ * @see UpdatableRecord#delete()
* @see Statement#executeBatch()
*/
@Support