OAK-10527 Improve readability of the explain query output
diff --git a/oak-core/src/main/java/org/apache/jackrabbit/oak/query/QueryFormatter.java b/oak-core/src/main/java/org/apache/jackrabbit/oak/query/QueryFormatter.java
index 65b33d1..4fb507a 100644
--- a/oak-core/src/main/java/org/apache/jackrabbit/oak/query/QueryFormatter.java
+++ b/oak-core/src/main/java/org/apache/jackrabbit/oak/query/QueryFormatter.java
@@ -65,10 +65,10 @@
}
/**
- * Format the query into a more human-readable way, by adding newlines.
- * Warning: newlines are also added inside e.g. string literals.
+ * Format the query into a more human-readable way, by adding newlines before
+ * keywords such as "where", "and", and "or".
*
- * @param query the query (may not be null)
+ * @param query the query (may not be null)
* @param language the query language, or null if unknown
* @return the formatted query
*/