From 5ad5f81ed2bfa18d2f921e269dc3adffc709e1fa Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Tue, 19 Mar 2024 16:28:21 +0100
Subject: [PATCH] [jOOQ/jOOQ#16484] Fix Javadoc of
 Settings.renderCoalesceToEmptyStringInConcat

---
 jOOQ/src/main/java/org/jooq/conf/Settings.java | 18 +++++++++---------
 .../org/jooq/xsd/jooq-runtime-3.20.0.xsd       |  6 +++---
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/jOOQ/src/main/java/org/jooq/conf/Settings.java b/jOOQ/src/main/java/org/jooq/conf/Settings.java
index 09419241fa..2061eed72b 100644
--- a/jOOQ/src/main/java/org/jooq/conf/Settings.java
+++ b/jOOQ/src/main/java/org/jooq/conf/Settings.java
@@ -1140,10 +1140,10 @@ public class Settings
     }
 
     /**
-     * Whether stored function calls should be wrapped in scalar subqueries.
+     * Whether string concatenation operands should be coalesced to empty strings.
      * <p>
-     * Oracle 11g (and potentially, other databases too) implements scalar subquery caching. With this flag
-     * set to true, users can automatically profit from this feature in all SQL statements.
+     * Some dialects treat <code>NULL</code> values as empty strings when concatenating strings (e.g. Oracle). For
+     * compatibility reasons, this flag allows for replicating this behaviour also elsewhere.
      * <p>
      * This feature is available in the commercial distribution only.
      * 
@@ -1157,10 +1157,10 @@ public class Settings
     }
 
     /**
-     * Whether stored function calls should be wrapped in scalar subqueries.
+     * Whether string concatenation operands should be coalesced to empty strings.
      * <p>
-     * Oracle 11g (and potentially, other databases too) implements scalar subquery caching. With this flag
-     * set to true, users can automatically profit from this feature in all SQL statements.
+     * Some dialects treat <code>NULL</code> values as empty strings when concatenating strings (e.g. Oracle). For
+     * compatibility reasons, this flag allows for replicating this behaviour also elsewhere.
      * <p>
      * This feature is available in the commercial distribution only.
      * 
@@ -6995,10 +6995,10 @@ public class Settings
     }
 
     /**
-     * Whether stored function calls should be wrapped in scalar subqueries.
+     * Whether string concatenation operands should be coalesced to empty strings.
      * <p>
-     * Oracle 11g (and potentially, other databases too) implements scalar subquery caching. With this flag
-     * set to true, users can automatically profit from this feature in all SQL statements.
+     * Some dialects treat <code>NULL</code> values as empty strings when concatenating strings (e.g. Oracle). For
+     * compatibility reasons, this flag allows for replicating this behaviour also elsewhere.
      * <p>
      * This feature is available in the commercial distribution only.
      * 
diff --git a/jOOQ/src/main/resources/org/jooq/xsd/jooq-runtime-3.20.0.xsd b/jOOQ/src/main/resources/org/jooq/xsd/jooq-runtime-3.20.0.xsd
index 1d858d2afa..6e95645496 100644
--- a/jOOQ/src/main/resources/org/jooq/xsd/jooq-runtime-3.20.0.xsd
+++ b/jOOQ/src/main/resources/org/jooq/xsd/jooq-runtime-3.20.0.xsd
@@ -195,10 +195,10 @@ unless DML joins are supported.]]></jxb:javadoc></jxb:property></appinfo></annot
       </element>
       
       <element name="renderCoalesceToEmptyStringInConcat" type="boolean" minOccurs="0" maxOccurs="1" default="false">
-        <annotation><appinfo><jxb:property><jxb:javadoc><![CDATA[Whether stored function calls should be wrapped in scalar subqueries.
+        <annotation><appinfo><jxb:property><jxb:javadoc><![CDATA[Whether string concatenation operands should be coalesced to empty strings.
 <p>
-Oracle 11g (and potentially, other databases too) implements scalar subquery caching. With this flag
-set to true, users can automatically profit from this feature in all SQL statements.
+Some dialects treat <code>NULL</code> values as empty strings when concatenating strings (e.g. Oracle). For
+compatibility reasons, this flag allows for replicating this behaviour also elsewhere.
 <p>
 This feature is available in the commercial distribution only.]]></jxb:javadoc></jxb:property></appinfo></annotation>
       </element>