--- JSON-XS/README	2008/06/03 06:43:45	1.26
+++ JSON-XS/README	2008/07/15 11:29:29	1.27
@@ -631,11 +631,19 @@
     stream incrementally. It does so by accumulating text until it has a
     full JSON object, which it then can decode. This process is similar to
     using "decode_prefix" to see if a full JSON object is available, but is
-    much more efficient (JSON::XS will only attempt to parse the JSON text
-    once it is sure it has enough text to get a decisive result, using a
-    very simple but truly incremental parser).
+    much more efficient (and can be implemented with a minimum of method
+    calls).
 
-    The following two methods deal with this.
+    JSON::XS will only attempt to parse the JSON text once it is sure it has
+    enough text to get a decisive result, using a very simple but truly
+    incremental parser. This means that it sometimes won't stop as early as
+    the full parser, for example, it doesn't detect parenthese mismatches.
+    The only thing it guarantees is that it starts decoding as soon as a
+    syntactically valid JSON text has been seen. This means you need to set
+    resource limits (e.g. "max_size") to ensure the parser will stop parsing
+    in the presence if syntax errors.
+
+    The following methods implement this incremental parser.
 
     [void, scalar or list context] = $json->incr_parse ([$string])
         This is the central parsing function. It can both append new text