From 78ac78fec9e11c4127af691462d552e6f668aebd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20G=C3=B6rler?= <adrian.goerler@sap.com>
Date: Tue, 3 Jun 2025 14:39:57 +0200
Subject: [PATCH 1/2] Document CDL Operators vs CAP Java Operators

---
 java/working-with-cql/query-api.md | 56 +++++++++++++++++-------------
 1 file changed, 31 insertions(+), 25 deletions(-)

diff --git a/java/working-with-cql/query-api.md b/java/working-with-cql/query-api.md
index e7f61c100..4b6b01834 100644
--- a/java/working-with-cql/query-api.md
+++ b/java/working-with-cql/query-api.md
@@ -1474,8 +1474,14 @@ These comparison operators are supported:
 <table>
 <thead>
 <tr>
+<th colspan="2" align=center>Operator</th><th/><th/>
+</tr>
+<tr>
+<th>
+    CAP Java
+</th>
 <th>
-    Predicate
+    CDL
 </th>
 <th width="400">
     Description
@@ -1488,11 +1494,9 @@ These comparison operators are supported:
 
 <tbody>
 <tr>
+<td>EQ</td><td>=</td>
 <td>
-EQ
-</td>
-<td>
-    Test if this value equals a given value. NULL values might be treated as unknown resulting in a three-valued logic as in SQL.
+    Test if this value equals a given value. NULL values might be treated as unknown resulting in a <i>three-valued logic</i> as in SQL.
 </td>
 <td align="left">
 <code>Select.from("bookshop.Books")
@@ -1502,11 +1506,9 @@ EQ
 </tr>
 
 <tr>
+<td>NE</td><td>&lt;&gt;</td>
 <td>
-NE
-</td>
-<td>
-    Test if this value is NOT equal to a given value. NULL values might be treated as unknown resulting in a three-valued logic as in SQL.
+    Test if this value is NOT equal to a given value. NULL values might be treated as unknown resulting in a <i>three-valued logic</i> as in SQL.
 </td>
 <td>
 <code>Select.from("bookshop.Books")
@@ -1516,11 +1518,9 @@ NE
 </tr>
 
 <tr>
+<td>IS</td><td>==</td>
 <td>
-IS
-</td>
-<td>
-    Test if this value equals a given value. NULL values are treated as any other value.
+    Test if this value equals a given value. NULL values are treated as any other value (<i>Boolean logic</i>).
 </td>
 <td>
 
@@ -1532,11 +1532,9 @@ IS
 </tr>
 
 <tr>
+<td>IS NOT</td><td>!=</td>
 <td>
-IS NOT
-</td>
-<td>
-    Test if this value is NOT equal to a given value. NULL values are treated as any other value.
+    Test if this value is NOT equal to a given value. NULL values are treated as any other value (<i>Boolean logic</i>).
 </td>
 <td>
 
@@ -1548,9 +1546,7 @@ IS NOT
 </tr>
 
 <tr>
-<td>
-GT
-</td>
+<td>GT</td><td>&gt;</td>
 <td>
     Test if this value is greater than a given value.
 </td>
@@ -1564,9 +1560,21 @@ GT
 </tr>
 
 <tr>
+<td>GE</td><td>&gt;=</td>
 <td>
-LT
+    Test if this value is greater than or equalt to a given value.
 </td>
+<td>
+
+<code>Select.from("bookshop.Books")
+  .where(b -> b.get("stock")
+  .<span class="na">ge</span>(5));</code>
+
+</td>
+</tr>
+
+<tr>
+<td>LT</td><td>&lt;</td>
 <td>
     Test if this value is less than a given value.
 </td>
@@ -1580,9 +1588,7 @@ LT
 </tr>
 
 <tr>
-<td>
-LE
-</td>
+<td>LE</td><td>&lt;=</td>
 <td>
     Test if this value is less than or equal to a given value.
 </td>
@@ -1596,7 +1602,7 @@ LE
 </tr>
 
 <tr>
-<td>
+<td colspan="2">
 BETWEEN
 </td>
 <td>

From 34ebb797a2ca30036ecd40442948b10f88c59a6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20G=C3=B6rler?= <adrian.goerler@sap.com>
Date: Tue, 3 Jun 2025 14:41:09 +0200
Subject: [PATCH 2/2] Update java/working-with-cql/query-api.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 java/working-with-cql/query-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/working-with-cql/query-api.md b/java/working-with-cql/query-api.md
index 4b6b01834..264a0347e 100644
--- a/java/working-with-cql/query-api.md
+++ b/java/working-with-cql/query-api.md
@@ -1562,7 +1562,7 @@ These comparison operators are supported:
 <tr>
 <td>GE</td><td>&gt;=</td>
 <td>
-    Test if this value is greater than or equalt to a given value.
+    Test if this value is greater than or equal to a given value.
 </td>
 <td>