--- CBOR-XS/README	2014/01/05 14:24:54	1.13
+++ CBOR-XS/README	2014/10/25 06:36:34	1.14
@@ -180,8 +180,13 @@
         If $enable is false (the default), then "decode" will throw an error
         when it encounters a self-referential/cyclic data structure.
 
+        FUTURE DIRECTION: the motivation behind this option is to avoid
+        *real* cycles - future versions of this module might chose to decode
+        cyclic data structures using weak references when this option is
+        off, instead of throwing an error.
+
         This option does not affect "encode" in any way - shared values and
-        references will always be decoded properly if present.
+        references will always be encoded properly if present.
 
     $cbor = $cbor->pack_strings ([$enable])
     $enabled = $cbor->get_pack_strings