ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/JSON-XS/XS.pm
(Generate patch)

Comparing JSON-XS/XS.pm (file contents):
Revision 1.123 by root, Sat Aug 8 10:06:02 2009 UTC vs.
Revision 1.124 by root, Sun Aug 9 16:01:39 2009 UTC

… …
1268 my $yaml = $to_yaml->encode ($ref) . "\n"; 1268 my $yaml = $to_yaml->encode ($ref) . "\n";
1269 1269
1270This will I<usually> generate JSON texts that also parse as valid 1270This will I<usually> generate JSON texts that also parse as valid
1271YAML. Please note that YAML has hardcoded limits on (simple) object key 1271YAML. Please note that YAML has hardcoded limits on (simple) object key
1272lengths that JSON doesn't have and also has different and incompatible 1272lengths that JSON doesn't have and also has different and incompatible
1273unicode handling, so you should make sure that your hash keys are 1273unicode character escape syntax, so you should make sure that your hash
1274noticeably shorter than the 1024 "stream characters" YAML allows and that 1274keys are noticeably shorter than the 1024 "stream characters" YAML allows
1275you do not have characters with codepoint values outside the Unicode BMP 1275and that you do not have characters with codepoint values outside the
1276(basic multilingual page). YAML also does not allow C<\/> sequences in 1276Unicode BMP (basic multilingual page). YAML also does not allow C<\/>
1277strings (which JSON::XS does not I<currently> generate, but other JSON 1277sequences in strings (which JSON::XS does not I<currently> generate, but
1278generators might). 1278other JSON generators might).
1279 1279
1280There might be other incompatibilities that I am not aware of (or the YAML 1280There might be other incompatibilities that I am not aware of (or the YAML
1281specification has been changed yet again - it does so quite often). In 1281specification has been changed yet again - it does so quite often). In
1282general you should not try to generate YAML with a JSON generator or vice 1282general you should not try to generate YAML with a JSON generator or vice
1283versa, or try to parse JSON with a YAML parser or vice versa: chances are 1283versa, or try to parse JSON with a YAML parser or vice versa: chances are
… …
1301proponents, I would kindly suggest reading the JSON spec (which is not 1301proponents, I would kindly suggest reading the JSON spec (which is not
1302that difficult or long) and finally make YAML compatible to it, and 1302that difficult or long) and finally make YAML compatible to it, and
1303educating users about the changes, instead of spreading lies about the 1303educating users about the changes, instead of spreading lies about the
1304real compatibility for many I<years> and trying to silence people who 1304real compatibility for many I<years> and trying to silence people who
1305point out that it isn't true. 1305point out that it isn't true.
1306
1307Addendum/2009: the YAML 1.2 spec is still incomaptible with JSON, even
1308though the incompatibilities have been documented (and are known to
1309Brian) for many years and the spec makes explicit claims that YAML is a
1310superset of JSON. It would be so easy to fix, but apparently, bullying and
1311corrupting userdata is so much easier.
1306 1312
1307=back 1313=back
1308 1314
1309 1315
1310=head2 SPEED 1316=head2 SPEED

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines