From 4167a01ce93189a905890918de87e577a242743a Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Tue, 8 Oct 2013 12:12:35 +0200
Subject: [PATCH] [#2770] Add reference to Javadoc with respect to missing
 feature.

---
 .../main/java/org/jooq/RecordListener.java    | 39 +++++++++++--------
 1 file changed, 22 insertions(+), 17 deletions(-)

diff --git a/jOOQ/src/main/java/org/jooq/RecordListener.java b/jOOQ/src/main/java/org/jooq/RecordListener.java
index 58e3f2f6c3..acf4fca792 100644
--- a/jOOQ/src/main/java/org/jooq/RecordListener.java
+++ b/jOOQ/src/main/java/org/jooq/RecordListener.java
@@ -40,24 +40,29 @@
  */
 package org.jooq;
 
-import java.util.EventListener;
+import java.util.EventListener;
 
-/**
- * A listener for manipulation events on {@link UpdatableRecord}s.
- * <p>
- * Users may want to centrally inject custom behaviour when manipulating their
- * {@link UpdatableRecord} objects, performing CRUD. This service provider
- * allows to hook in callback method implementations for before or after any of
- * these methods:
- * <ul>
- * <li>{@link UpdatableRecord#store()}</li>
- * <li>{@link UpdatableRecord#insert()}</li>
- * <li>{@link UpdatableRecord#update()}</li>
- * <li>{@link UpdatableRecord#delete()}</li>
- * <li>{@link UpdatableRecord#refresh()}</li>
- * </ul>
- *
- * @author Lukas Eder
+/**
+ * A listener for manipulation events on {@link UpdatableRecord}s.
+ * <p>
+ * Users may want to centrally inject custom behaviour when manipulating their
+ * {@link UpdatableRecord} objects, performing CRUD. This service provider
+ * allows to hook in callback method implementations for before or after any of
+ * these methods:
+ * <ul>
+ * <li>{@link UpdatableRecord#store()}</li>
+ * <li>{@link UpdatableRecord#insert()}</li>
+ * <li>{@link UpdatableRecord#update()}</li>
+ * <li>{@link UpdatableRecord#delete()}</li>
+ * <li>{@link UpdatableRecord#refresh()}</li>
+ * </ul>
+ * <p>
+ * As of jOOQ 3.2, the <code>RecordListener</code> API behaviour is not defined
+ * for batch CRUD operations, such as
+ * {@link DSLContext#batchStore(UpdatableRecord...)}. This will be corrected in
+ * a future version of jOOQ [#2770].
+ *
+ * @author Lukas Eder
  */
 public interface RecordListener extends EventListener {