[#2770] Add reference to Javadoc with respect to missing feature.

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 {