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
      */