From 9dd975884495fcb4f1f96ba162b8d4d644cd1ecd Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Fri, 9 Dec 2022 14:57:09 +0100
Subject: [PATCH] [jOOQ/jOOQ#14388] Deprecate PostgresDSL::arrayCat

---
 .../org/jooq/util/postgres/PostgresDSL.java   | 24 +++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/jOOQ/src/main/java/org/jooq/util/postgres/PostgresDSL.java b/jOOQ/src/main/java/org/jooq/util/postgres/PostgresDSL.java
index 403dbd8897..2408db1775 100644
--- a/jOOQ/src/main/java/org/jooq/util/postgres/PostgresDSL.java
+++ b/jOOQ/src/main/java/org/jooq/util/postgres/PostgresDSL.java
@@ -239,10 +239,18 @@ public class PostgresDSL extends DSL {
     /**
      * The PostgreSQL <code>array_cat(anyarray, anyelement)</code> function.
      * <p>
-     * Example: <pre><code>
+     * Example:
+     *
+     * <pre>
+     * <code>
      * {1, 2, 3, 4, 5} = array_cat(ARRAY[1, 2], ARRAY[3, 4, 5])
-     * </code></pre>
+     * </code>
+     * </pre>
+     *
+     * @deprecated - 3.16.0 - [#14388] - Use
+     *             {@link DSL#arrayConcat(Object[], Object[])} instead.
      */
+    @Deprecated
     @NotNull
     @Support({ POSTGRES, YUGABYTEDB })
     public static <T> Field<T[]> arrayCat(T[] array1, T[] array2) {
@@ -255,7 +263,11 @@ public class PostgresDSL extends DSL {
      * Example: <pre><code>
      * {1, 2, 3, 4, 5} = array_cat(ARRAY[1, 2], ARRAY[3, 4, 5])
      * </code></pre>
+     *
+     * @deprecated - 3.16.0 - [#14388] - Use
+     *             {@link DSL#arrayConcat(Object[], Field)} instead.
      */
+    @Deprecated
     @NotNull
     @Support({ POSTGRES, YUGABYTEDB })
     public static <T> Field<T[]> arrayCat(T[] array1, Field<T[]> array2) {
@@ -268,7 +280,11 @@ public class PostgresDSL extends DSL {
      * Example: <pre><code>
      * {1, 2, 3, 4, 5} = array_cat(ARRAY[1, 2], ARRAY[3, 4, 5])
      * </code></pre>
+     *
+     * @deprecated - 3.16.0 - [#14388] - Use
+     *             {@link DSL#arrayConcat(Field, Object[])} instead.
      */
+    @Deprecated
     @NotNull
     @Support({ POSTGRES, YUGABYTEDB })
     public static <T> Field<T[]> arrayCat(Field<T[]> array1, T[] array2) {
@@ -281,7 +297,11 @@ public class PostgresDSL extends DSL {
      * Example: <pre><code>
      * {1, 2, 3, 4, 5} = array_cat(ARRAY[1, 2], ARRAY[3, 4, 5])
      * </code></pre>
+     *
+     * @deprecated - 3.16.0 - [#14388] - Use
+     *             {@link DSL#arrayConcat(Field, Field)} instead.
      */
+    @Deprecated
     @NotNull
     @Support({ POSTGRES, YUGABYTEDB })
     public static <T> Field<T[]> arrayCat(Field<T[]> array1, Field<T[]> array2) {