diff --git a/jOOQ/src/main/java/org/jooq/DeleteOrderByStep.java b/jOOQ/src/main/java/org/jooq/DeleteOrderByStep.java
index d3c31968ca..5fd72e119c 100644
--- a/jOOQ/src/main/java/org/jooq/DeleteOrderByStep.java
+++ b/jOOQ/src/main/java/org/jooq/DeleteOrderByStep.java
@@ -95,7 +95,7 @@ public interface DeleteOrderByStep<R extends Record> extends DeleteLimitStep<R>
      * Indexes start at <code>1</code> in SQL!
      * <p>
      * Note, you can use <code>orderBy(DSL.val(1).desc())</code> or
-     * <code>orderBy(DSL.literal(1).desc())</code> to apply descending
+     * <code>orderBy(DSL.inline(1).desc())</code> to apply descending
      * ordering
      */
     @NotNull @CheckReturnValue
diff --git a/jOOQ/src/main/java/org/jooq/SelectOrderByStep.java b/jOOQ/src/main/java/org/jooq/SelectOrderByStep.java
index 0143fda71d..71ad58b0fc 100644
--- a/jOOQ/src/main/java/org/jooq/SelectOrderByStep.java
+++ b/jOOQ/src/main/java/org/jooq/SelectOrderByStep.java
@@ -286,7 +286,7 @@ public interface SelectOrderByStep<R extends Record> extends SelectLimitStep<R>
      * Indexes start at <code>1</code> in SQL!
      * <p>
      * Note, you can use <code>orderBy(DSL.val(1).desc())</code> or
-     * <code>orderBy(DSL.literal(1).desc())</code> to apply descending
+     * <code>orderBy(DSL.inline(1).desc())</code> to apply descending
      * ordering
      */
     @NotNull @CheckReturnValue
diff --git a/jOOQ/src/main/java/org/jooq/SelectQuery.java b/jOOQ/src/main/java/org/jooq/SelectQuery.java
index f8baf6c3b3..c77ff9775e 100644
--- a/jOOQ/src/main/java/org/jooq/SelectQuery.java
+++ b/jOOQ/src/main/java/org/jooq/SelectQuery.java
@@ -788,7 +788,7 @@ public interface SelectQuery<R extends Record> extends Select<R>, ConditionProvi
      * Indexes start at <code>1</code> in SQL!
      * <p>
      * Note, you can use <code>addOrderBy(DSL.val(1).desc())</code> or
-     * <code>addOrderBy(DSL.literal(1).desc())</code> to apply descending
+     * <code>addOrderBy(DSL.inline(1).desc())</code> to apply descending
      * ordering
      *
      * @param fieldIndexes The ordering fields
diff --git a/jOOQ/src/main/java/org/jooq/UpdateOrderByStep.java b/jOOQ/src/main/java/org/jooq/UpdateOrderByStep.java
index b426fd5e18..629bdf9473 100644
--- a/jOOQ/src/main/java/org/jooq/UpdateOrderByStep.java
+++ b/jOOQ/src/main/java/org/jooq/UpdateOrderByStep.java
@@ -97,7 +97,7 @@ public interface UpdateOrderByStep<R extends Record> extends UpdateLimitStep<R>
      * Indexes start at <code>1</code> in SQL!
      * <p>
      * Note, you can use <code>orderBy(DSL.val(1).desc())</code> or
-     * <code>orderBy(DSL.literal(1).desc())</code> to apply descending
+     * <code>orderBy(DSL.inline(1).desc())</code> to apply descending
      * ordering
      */
     @NotNull @CheckReturnValue