diff --git a/jOOQ/src/main/java/org/jooq/Table.java b/jOOQ/src/main/java/org/jooq/Table.java
index bba3354953..28c1ad9886 100644
--- a/jOOQ/src/main/java/org/jooq/Table.java
+++ b/jOOQ/src/main/java/org/jooq/Table.java
@@ -343,6 +343,13 @@ extends
     /**
      * Create a qualified asterisk expression from this table
      * (<code>table.*</code>) for use with <code>SELECT</code>.
+     * <p>
+     * When using an asterisk, jOOQ will let the database server define the
+     * order of columns, as well as which columns are included in the result
+     * set. If using jOOQ with generated code, this may conflict with the column
+     * set and its ordering as defined at code generation time, meaning columns
+     * may be in a different order, there may be fewer or more columns than
+     * expected. It is usually better to list columns explicitly.
      *
      * @see DSL#asterisk()
      */
diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java
index 3cc829d0f1..95d2b2a88e 100644
--- a/jOOQ/src/main/java/org/jooq/impl/DSL.java
+++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java
@@ -29827,6 +29827,13 @@ public class DSL {
 
     /**
      * The asterisk (<code>*</code>) to be used in <code>SELECT</code> clauses.
+     * <p>
+     * When using an asterisk, jOOQ will let the database server define the
+     * order of columns, as well as which columns are included in the result
+     * set. If using jOOQ with generated code, this may conflict with the column
+     * set and its ordering as defined at code generation time, meaning columns
+     * may be in a different order, there may be fewer or more columns than
+     * expected. It is usually better to list columns explicitly.
      */
     @NotNull
     @Support