From 45fa639f973d7b53344bd4571249abe90dafdbcb Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@datageekery.com>
Date: Fri, 5 Jul 2024 15:15:09 +0200
Subject: [PATCH] [jOOQ/jOOQ#16918] Clarify in manual and Javadoc that NoXYZ
 QueryParts are to be used only with the DSL API, not with the QOM API

---
 jOOQ/src/main/java/org/jooq/impl/DSL.java | 30 +++++++++++++++++++++++
 1 file changed, 30 insertions(+)

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 <code>FROM</code> clause or a join
      * operation.
+     * <p>
+     * <b>NOTE [#16918]</b> 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 <code>NULL</code> and cannot be used
      * to avoid the clause.
+     * <p>
+     * <b>NOTE [#16918]</b> 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)}.
+     * <p>
+     * <b>NOTE [#16918]</b> 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 <code>NULL</code> and cannot be used
      * to avoid the clause.
+     * <p>
+     * <b>NOTE [#16918]</b> 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 <code>NULL</code> and cannot be used
      * to avoid the clause.
+     * <p>
+     * <b>NOTE [#16918]</b> 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 {
      * <pre><code>
      * SELECT * FROM t
      * </code></pre>
+     * <p>
+     * <b>NOTE [#16918]</b> 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