From 08114dfb483e8d6525faafef4ab4197788f9260c Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Fri, 17 Dec 2021 10:20:16 +0100
Subject: [PATCH] [jOOQ/jOOQ#12755] DSL.unquotedName() has wrong Javadoc

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

diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java
index 1f71e6c042..0f1eee0f51 100644
--- a/jOOQ/src/main/java/org/jooq/impl/DSL.java
+++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java
@@ -11666,8 +11666,10 @@ public class DSL {
      * Create a new SQL identifier using an unqualified, quoted name.
      * <p>
      * This works like {@link #name(String...)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * identifiers will be quoted by default in databases that support quoted
+     * identifiers, exept if forced to be unquoted using
+     * {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#NEVER}.
      *
      * @param unqualifiedName The SQL identifier's unqualified name
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11682,8 +11684,10 @@ public class DSL {
      * Create a new SQL identifier using a qualified, quoted name.
      * <p>
      * This works like {@link #name(String...)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * identifiers will be quoted by default in databases that support quoted
+     * identifiers, exept if forced to be unquoted using
+     * {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#NEVER}.
      *
      * @param qualifiedName The SQL identifier's qualified name parts
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11698,8 +11702,10 @@ public class DSL {
      * Create a new SQL identifier using a qualified, quoted name.
      * <p>
      * This works like {@link #name(Collection)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * identifiers will be quoted by default in databases that support quoted
+     * identifiers, exept if forced to be unquoted using
+     * {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#NEVER}.
      *
      * @param qualifiedName The SQL identifier's qualified name parts
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11713,9 +11719,10 @@ public class DSL {
     /**
      * Create a new SQL identifier using an unqualified, quoted name.
      * <p>
-     * This works like {@link #name(String...)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * This works like {@link #name(String)}, except that generated
+     * identifiers will be unquoted by default, except if forced to be quoted
+     * using {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#ALWAYS}.
      *
      * @param unqualifiedName The SQL identifier's unqualified name
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11730,8 +11737,9 @@ public class DSL {
      * Create a new SQL identifier using a qualified, quoted name.
      * <p>
      * This works like {@link #name(String...)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * identifiers will be unquoted by default, except if forced to be quoted
+     * using {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#ALWAYS}.
      *
      * @param qualifiedName The SQL identifier's qualified name parts
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11749,8 +11757,9 @@ public class DSL {
      * Create a new SQL identifier using a qualified, quoted name.
      * <p>
      * This works like {@link #name(Collection)}, except that generated
-     * identifiers will be guaranteed to be quoted in databases that support
-     * quoted identifiers.
+     * identifiers will be unquoted by default, except if forced to be quoted
+     * using {@link Settings#getRenderQuotedNames()} with value
+     * {@link RenderQuotedNames#ALWAYS}.
      *
      * @param qualifiedName The SQL identifier's qualified name parts
      * @return A {@link QueryPart} that will render the SQL identifier
@@ -11764,7 +11773,7 @@ public class DSL {
     /**
      * Create a new SQL identifier using an unqualified, quoted name.
      * <p>
-     * This works like {@link #name(String...)}, except that generated
+     * This works like {@link #unquotedName(String)}, except that generated
      * identifiers will be guaranteed to be unquoted, even when the relevant
      * {@link Settings#getRenderQuotedNames()} flag is set to
      * {@link RenderQuotedNames#ALWAYS}.
@@ -11781,7 +11790,7 @@ public class DSL {
     /**
      * Create a new SQL identifier using a qualified, quoted name.
      * <p>
-     * This works like {@link #name(String...)}, except that generated
+     * This works like {@link #unquotedName(String...)}, except that generated
      * identifiers will be guaranteed to be unquoted, even when the relevant
      * {@link Settings#getRenderQuotedNames()} flag is set to
      * {@link RenderQuotedNames#ALWAYS}.
@@ -11801,7 +11810,7 @@ public class DSL {
     /**
      * Create a new SQL identifier using a qualified, system name.
      * <p>
-     * This works like {@link #name(Collection)}, except that generated
+     * This works like {@link #unquotedName(Collection)}, except that generated
      * identifiers will be guaranteed to be unquoted, even when the relevant
      * {@link Settings#getRenderQuotedNames()} flag is set to
      * {@link RenderQuotedNames#ALWAYS}.