From ae122cf29e8f905ffd40f04860710b6de0469439 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Fri, 14 Oct 2022 10:17:58 +0200
Subject: [PATCH] [jOOQ/jOOQ#14098] Document the fact that some DDL emulations
 may require the commercial editions

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

diff --git a/jOOQ/src/main/java/org/jooq/DDLQuery.java b/jOOQ/src/main/java/org/jooq/DDLQuery.java
index c294f32ec1..15bd4c5fa0 100644
--- a/jOOQ/src/main/java/org/jooq/DDLQuery.java
+++ b/jOOQ/src/main/java/org/jooq/DDLQuery.java
@@ -37,9 +37,21 @@
  */
 package org.jooq;
 
+import org.jooq.impl.DSL;
 
 /**
  * A marker interface for all DDL queries.
+ * <p>
+ * A lot of DDL queries come with syntax that requires emulation using anonymous
+ * blocks via {@link DSL#begin(Statement...)}. While basic anonymous blocks are
+ * supported in the jOOQ Open Source Edition as well, more sophisticated blocks
+ * and other procedural logic is a commercial only feature. Examples for this
+ * are:
+ * <ul>
+ * <li>Various <code>IF [ NOT ] EXISTS</code> clauses.</li>
+ * <li><code>ALTER VIEW … AS</code> (emulated via a block containing
+ * <code>DROP VIEW</code> and then <code>CREATE VIEW</code>).</li>
+ * </ul>
  *
  * @author Lukas Eder
  */