--- JSON-XS/XS.pm	2007/03/23 18:37:30	1.13
+++ JSON-XS/XS.pm	2007/03/23 19:02:02	1.14
@@ -314,7 +314,7 @@
 =item object
 
 A JSON object becomes a reference to a hash in Perl. No ordering of object
-keys is preserved.
+keys is preserved (JSON does not preserver object key ordering itself).
 
 =item array
 
@@ -360,7 +360,7 @@
 Perl hash references become JSON objects. As there is no inherent ordering
 in hash keys, they will usually be encoded in a pseudo-random order that
 can change between runs of the same program but stays generally the same
-within the single run of a program. JSON::XS can optionally sort the hash
+within a single run of a program. JSON::XS can optionally sort the hash
 keys (determined by the I<canonical> flag), so the same datastructure
 will serialise to the same JSON text (given same settings and version of
 JSON::XS), but this incurs a runtime overhead.