diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java
index c149367a22..8306fc3218 100644
--- a/jOOQ/src/main/java/org/jooq/impl/DSL.java
+++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java
@@ -13398,6 +13398,11 @@ public class DSL {
* query or not. In case that clause accepts tables, the {@link #noTable()}
* can be used to avoid creating a FROM clause or a join
* operation.
+ *
+ * NOTE [#16918] that this {@link Table} is meant to be used with the
+ * {@link DSL} API only, not with the {@link QOM} API, which cannot offer
+ * any no-op operations. The behaviour when used with the {@link QOM} API is
+ * undefined.
*/
@NotNull
@Support
@@ -13428,6 +13433,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects NULL and cannot be used
* to avoid the clause.
+ *
+ * NOTE [#16918] that this {@link Field} is meant to be used with the + * {@link DSL} API only, not with the {@link QOM} API, which cannot offer + * any no-op operations. The behaviour when used with the {@link QOM} API is + * undefined. */ @NotNull @Support @@ -13464,6 +13474,11 @@ public class DSL { * {@link SQLDataType}. If you're using any custom data types by means of a * {@link Converter} or {@link Binding}, it's better to pass that converted * {@link DataType} reference explicitly to {@link #noField(DataType)}. + *
+ * NOTE [#16918] that this {@link Field} is meant to be used with the
+ * {@link DSL} API only, not with the {@link QOM} API, which cannot offer
+ * any no-op operations. The behaviour when used with the {@link QOM} API is
+ * undefined.
*
* @param type A class to derive the {@link Field#getDataType()} from.
*/
@@ -13496,6 +13511,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects NULL and cannot be used
* to avoid the clause.
+ *
+ * NOTE [#16918] that this {@link Field} is meant to be used with the
+ * {@link DSL} API only, not with the {@link QOM} API, which cannot offer
+ * any no-op operations. The behaviour when used with the {@link QOM} API is
+ * undefined.
*
* @param type A type to derive the {@link Field#getDataType()} from.
*/
@@ -13528,6 +13548,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects NULL and cannot be used
* to avoid the clause.
+ *
+ * NOTE [#16918] that this {@link Field} is meant to be used with the + * {@link DSL} API only, not with the {@link QOM} API, which cannot offer + * any no-op operations. The behaviour when used with the {@link QOM} API is + * undefined. * * @param type A field to derive the {@link Field#getDataType()} from. */ @@ -16460,6 +16485,11 @@ public class DSL { *
* SELECT * FROM t
*
+ * + * NOTE [#16918] that this {@link Condition} is meant to be used with the + * {@link DSL} API only, not with the {@link QOM} API, which cannot offer + * any no-op operations. The behaviour when used with the {@link QOM} API is + * undefined. */ @NotNull @Support