--- JSON-XS/README	2007/07/02 08:06:48	1.15
+++ JSON-XS/README	2007/07/26 11:33:35	1.16
@@ -504,12 +504,25 @@
         so no manual decoding is necessary.
 
     number
-        A JSON number becomes either an integer or numeric (floating point)
-        scalar in perl, depending on its range and any fractional parts. On
-        the Perl level, there is no difference between those as Perl handles
-        all the conversion details, but an integer may take slightly less
-        memory and might represent more values exactly than (floating point)
-        numbers.
+        A JSON number becomes either an integer, numeric (floating point) or
+        string scalar in perl, depending on its range and any fractional
+        parts. On the Perl level, there is no difference between those as
+        Perl handles all the conversion details, but an integer may take
+        slightly less memory and might represent more values exactly than
+        (floating point) numbers.
+
+        If the number consists of digits only, JSON::XS will try to
+        represent it as an integer value. If that fails, it will try to
+        represent it as a numeric (floating point) value if that is possible
+        without loss of precision. Otherwise it will preserve the number as
+        a string value.
+
+        Numbers containing a fractional or exponential part will always be
+        represented as numeric (floating point) values, possibly at a loss
+        of precision.
+
+        This might create round-tripping problems as numbers might become
+        strings, but as Perl is typeless there is no other way to do it.
 
     true, false
         These JSON atoms become "JSON::XS::true" and "JSON::XS::false",