[#6427] Deprecate partitionByOne() API

jOOQ/src/main/java/org/jooq/WindowPartitionByStep.java

@@ -77,7 +77,12 @@ public interface WindowPartitionByStep<T> extends WindowOrderByStep<T> {
      * <p>
      * This clause is not supported as such in the CUBRID and Sybase dialects.
      * If you use it, jOOQ will simply ignore it.
+     *
+     * @deprecated - 3.10 - [#6427] - This synthetic clause is no longer
+     *             supported, use {@link #partitionBy(Field...)} instead, or
+     *             omit the clause entirely.
      */
+    @Deprecated
     @Support({ CUBRID, FIREBIRD_3_0, MYSQL_8_0, POSTGRES })
     WindowOrderByStep<T> partitionByOne();
 

jOOQ/src/main/java/org/jooq/WindowSpecificationPartitionByStep.java

@@ -82,7 +82,12 @@ public interface WindowSpecificationPartitionByStep extends WindowSpecificationO
      * <p>
      * This clause is not supported as such in the CUBRID and Sybase dialects.
      * If you use it, jOOQ will simply ignore it.
+     *
+     * @deprecated - 3.10 - [#6427] - This synthetic clause is no longer
+     *             supported, use {@link #partitionBy(Field...)} instead, or
+     *             omit the clause entirely.
      */
+    @Deprecated
     @Support({ CUBRID, FIREBIRD_3_0, MYSQL_8_0, POSTGRES })
     WindowSpecificationOrderByStep partitionByOne();
 }

jOOQ/src/main/java/org/jooq/impl/Function.java

@@ -622,6 +622,7 @@ class Function<T> extends AbstractField<T> implements
     }
 
     @Override
+    @Deprecated
     public final WindowOrderByStep<T> partitionByOne() {
         windowSpecification.partitionByOne();
         return this;

jOOQ/src/main/java/org/jooq/impl/WindowSpecificationImpl.java

@@ -169,6 +169,7 @@ final class WindowSpecificationImpl extends AbstractQueryPart implements
     }
 
     @Override
+    @Deprecated
     public final WindowSpecificationOrderByStep partitionByOne() {
         partitionByOne = true;
         partitionBy.add(one());