--- JSON-XS/XS.pm	2008/05/24 21:55:43	1.105
+++ JSON-XS/XS.pm	2008/05/27 05:31:39	1.106
@@ -766,6 +766,15 @@
 died, in which case the input buffer and incremental parser state is left
 unchanged, to skip the text parsed so far and to reset the parse state.
 
+=item $json->incr_reset
+
+This completely resets the incremental parser, that is, after this call,
+it will be as if the parser had never parsed anything.
+
+This is useful if you want ot repeatedly parse JSON objects and want to
+ignore any trailing data, which means you have to reset the parser after
+each successful decode.
+
 =back
 
 =head2 LIMITATIONS