--- CBOR-XS/XS.pm	2014/01/05 14:24:54	1.40
+++ CBOR-XS/XS.pm	2014/01/06 04:15:31	1.41
@@ -220,6 +220,11 @@
 If C<$enable> is false (the default), then C<decode> will throw an error
 when it encounters a self-referential/cyclic data structure.
 
+FUTURE DIRECTION: the motivation behind this option is to avoid I<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 C<encode> in any way - shared values and
 references will always be decoded properly if present.