--- JSON-XS/XS.pm	2007/03/23 15:10:55	1.7
+++ JSON-XS/XS.pm	2007/03/23 15:57:18	1.8
@@ -226,7 +226,10 @@
 strings.  This flag optionally resizes strings generated by either
 C<encode> or C<decode> to their minimum size possible. This can save
 memory when your JSON strings are either very very long or you have many
-short strings.
+short strings. It will also try to downgrade any strings to octet-form
+if possible: perl stores strings internally either in an encoding called
+UTF-X or in octet-form. The latter cannot store everything but uses less
+space in general.
 
 If C<$enable> is true (or missing), the string returned by C<encode> will be shrunk-to-fit,
 while all strings generated by C<decode> will also be shrunk-to-fit.