From 08d0a35da7c2c8bac06dda86a99c172a2ca2f1ef Mon Sep 17 00:00:00 2001
From: "leonid.stashevsky" <leonid.stashevsky@gmail.com>
Date: Mon, 15 Jan 2024 13:46:38 +0100
Subject: [PATCH] fixup! In the convenience methods for `join`, make column
 equality optional

---
 .../src/main/kotlin/org/jetbrains/exposed/sql/Table.kt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt b/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt
index c672ea8e80..52d6c17e48 100644
--- a/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt
+++ b/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt
@@ -140,6 +140,8 @@ abstract class ColumnSet : FieldSet {
 /**
  * Creates an inner join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.innerJoin(
     otherTable: C2,
@@ -151,6 +153,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.innerJoin(
 /**
  * Creates a left outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.leftJoin(
     otherTable: C2,
@@ -162,6 +166,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.leftJoin(
 /**
  * Creates a right outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.rightJoin(
     otherTable: C2,
@@ -173,6 +179,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.rightJoin(
 /**
  * Creates a full outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.fullJoin(
     otherTable: C2,
@@ -184,6 +192,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.fullJoin(
 /**
  * Creates a cross join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.crossJoin(
     otherTable: C2,