--- JSON-XS/XS.pm	2007/03/25 02:32:40	1.21
+++ JSON-XS/XS.pm	2007/03/25 02:37:00	1.22
@@ -6,15 +6,17 @@
 
  use JSON::XS;
 
- # exported functions, croak on error
+ # exported functions, they croak on error
+ # and expect/generate UTF-8
 
  $utf8_encoded_json_text = to_json $perl_hash_or_arrayref;
  $perl_hash_or_arrayref  = from_json $utf8_encoded_json_text;
 
- # objToJson and jsonToObj are exported for JSON
- # compatibility, but should not be used in new code.
+ # objToJson and jsonToObj aliases to to_json and from_json
+ # are exported for compatibility to the JSON module,
+ # but should not be used in new code.
 
- # oo-interface
+ # OO-interface
 
  $coder = JSON::XS->new->ascii->pretty->allow_nonref;
  $pretty_printed_unencoded = $coder->encode ($perl_scalar);