Add deprecation notices

Author: jeffgbutler

src/main/java/org/mybatis/dynamic/sql/SqlBuilder.java

@@ -435,6 +435,32 @@ static <T> ColumnAndConditionCriterion<T> on(BindableColumn<T> joinColumn, Visit
                 .build();
     }
 
+    /**
+     * Starting in version 2.0.0, this function is a synonym for {@link SqlBuilder#isEqualTo(BasicColumn)}.
+     *
+     * @param column the column
+     * @return an IsEqualToColumn condition
+     * @param <T> the column type
+     * @deprecated since 2.0.0. Please replace with isEqualTo(column)
+     */
+    @Deprecated(since = "2.0.0", forRemoval = true)
+    static <T> IsEqualToColumn<T> equalTo(BindableColumn<T> column) {
+        return isEqualTo(column);
+    }
+
+    /**
+     * Starting in version 2.0.0, this function is a synonym for {@link SqlBuilder#isEqualTo(Object)}.
+     *
+     * @param value the value
+     * @return an IsEqualTo condition
+     * @param <T> the column type
+     * @deprecated since 2.0.0. Please replace with isEqualTo(value)
+     */
+    @Deprecated(since = "2.0.0", forRemoval = true)
+    static <T> IsEqualTo<T> equalTo(T value) {
+        return isEqualTo(value);
+    }
+
     // case expressions
     @SuppressWarnings("java:S100")
     static <T> SimpleCaseDSL<T> case_(BindableColumn<T> column) {
@@ -446,16 +472,6 @@ static SearchedCaseDSL case_() {
         return SearchedCaseDSL.searchedCase();
     }
 
-    // TODO - Deprecate?
-    static <T> IsEqualToColumn<T> equalTo(BindableColumn<T> column) {
-        return IsEqualToColumn.of(column);
-    }
-
-    // TODO - Deprecate?
-    static <T> IsEqualTo<T> equalTo(T value) {
-        return IsEqualTo.of(value);
-    }
-
     // aggregate support
     static CountAll count() {
         return new CountAll();

src/main/kotlin/org/mybatis/dynamic/sql/util/kotlin/JoinCollector.kt

@@ -33,20 +33,20 @@ class JoinCollector {
         criteriaCollector.apply(receiver)
     }
 
-    // TODO - Deprecate?
+    @Deprecated("Please replace with the \"on\" lambda expression", level = DeprecationLevel.WARNING)
     fun <T> on(leftColumn: BindableColumn<T>): RightColumnCollector<T> = RightColumnCollector {
         assertNull(criteriaCollector.initialCriterion, "ERROR.45") //$NON-NLS-1$
         criteriaCollector.apply { leftColumn.invoke(it) }
     }
 
-    // TODO - Deprecate?
+    @Deprecated("Please move the \"and\" expression into an \"on\" lambda", level = DeprecationLevel.WARNING)
     fun <T> and(leftColumn: BindableColumn<T>): RightColumnCollector<T> = RightColumnCollector {
         criteriaCollector.and { leftColumn.invoke(it) }
     }
 }
 
 class RightColumnCollector<T>(private val joinConditionConsumer: (VisitableCondition<T>) -> Unit) {
-    infix fun equalTo(rightColumn: BindableColumn<T>) = joinConditionConsumer.invoke(SqlBuilder.equalTo(rightColumn))
+    infix fun equalTo(rightColumn: BindableColumn<T>) = joinConditionConsumer.invoke(SqlBuilder.isEqualTo(rightColumn))
 
-    infix fun equalTo(value: T) = joinConditionConsumer.invoke(SqlBuilder.equalTo(value))
+    infix fun equalTo(value: T) = joinConditionConsumer.invoke(SqlBuilder.isEqualTo(value))
 }