From 9a13287b359137454876d1e0d36a8a15b046853e Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Fri, 18 Sep 2020 09:43:49 +0200
Subject: [PATCH] [jOOQ/jOOQ#10646] Document that import-on-demand cannot be
 used with org.jooq.Record

---
 jOOQ/src/main/java/org/jooq/Record.java | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/Record.java b/jOOQ/src/main/java/org/jooq/Record.java
index 2d421d253b..1aedb8e0c7 100644
--- a/jOOQ/src/main/java/org/jooq/Record.java
+++ b/jOOQ/src/main/java/org/jooq/Record.java
@@ -99,6 +99,28 @@ import org.jetbrains.annotations.Nullable;
  * jOOQ records have a natural ordering implemented in the same way as this is
  * defined in the SQL standard. For more details, see the
  * {@link #compareTo(Record)} method.
+ * <p>
+ * <h5>Importing Record</h5>
+ * <p>
+ * Starting from Java 14, the <code>Record</code> type conflicts with
+ * {@link java.lang.Record}, which is always imported by default. According to
+ * Java Language Specification, this means that jOOQ's <code>Record</code> type
+ * can no longer be imported on demand. This is not sufficient:
+ *
+ * <pre>
+ * <code>
+ * import org.jooq.*;
+ * </code>
+ * </pre>
+ *
+ * You have to do this instead:
+ *
+ * <pre>
+ * <code>
+ * import org.jooq.*;
+ * import org.jooq.Record;
+ * </code>
+ * </pre>
  *
  * @author Lukas Eder
  * @see Result