[#4731] Add Javadoc warning to Table.equals() to help prevent accidental usage

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

@@ -1632,6 +1632,15 @@ public interface Table<R extends Record> extends TableLike<R> {
     @Support
     Condition equal(Table<R> table);
 
+    /**
+     * {@inheritDoc}
+     * <p>
+     * <strong>Watch out! This is {@link Object#equals(Object)}, not a jOOQ DSL
+     * feature!</strong>
+     */
+    @Override
+    boolean equals(Object other);
+
     /**
      * Create a predicate comparing records from self-non-equi-joined tables.
      * <p>