/Modules/cjkcodecs/README

http://unladen-swallow.googlecode.com/ · #! · 79 lines · 54 code · 25 blank · 0 comment · 0 complexity · 2e930f1b3efb9164327662713c02f4fa MD5 · raw file

  1. To generate or modify mapping headers
  2. -------------------------------------
  3. Mapping headers are imported from CJKCodecs as pre-generated form.
  4. If you need to tweak or add something on it, please look at tools/
  5. subdirectory of CJKCodecs' distribution.
  6. Notes on implmentation characteristics of each codecs
  7. -----------------------------------------------------
  8. 1) Big5 codec
  9. The big5 codec maps the following characters as cp950 does rather
  10. than conforming Unicode.org's that maps to 0xFFFD.
  11. BIG5 Unicode Description
  12. 0xA15A 0x2574 SPACING UNDERSCORE
  13. 0xA1C3 0xFFE3 SPACING HEAVY OVERSCORE
  14. 0xA1C5 0x02CD SPACING HEAVY UNDERSCORE
  15. 0xA1FE 0xFF0F LT DIAG UP RIGHT TO LOW LEFT
  16. 0xA240 0xFF3C LT DIAG UP LEFT TO LOW RIGHT
  17. 0xA2CC 0x5341 HANGZHOU NUMERAL TEN
  18. 0xA2CE 0x5345 HANGZHOU NUMERAL THIRTY
  19. Because unicode 0x5341, 0x5345, 0xFF0F, 0xFF3C is mapped to another
  20. big5 codes already, a roundtrip compatibility is not guaranteed for
  21. them.
  22. 2) cp932 codec
  23. To conform to Windows's real mapping, cp932 codec maps the following
  24. codepoints in addition of the official cp932 mapping.
  25. CP932 Unicode Description
  26. 0x80 0x80 UNDEFINED
  27. 0xA0 0xF8F0 UNDEFINED
  28. 0xFD 0xF8F1 UNDEFINED
  29. 0xFE 0xF8F2 UNDEFINED
  30. 0xFF 0xF8F3 UNDEFINED
  31. 3) euc-jisx0213 codec
  32. The euc-jisx0213 codec maps JIS X 0213 Plane 1 code 0x2140 into
  33. unicode U+FF3C instead of U+005C as on unicode.org's mapping.
  34. Because euc-jisx0213 has REVERSE SOLIDUS on 0x5c already and A140
  35. is shown as a full width character, mapping to U+FF3C can make
  36. more sense.
  37. The euc-jisx0213 codec is enabled to decode JIS X 0212 codes on
  38. codeset 2. Because JIS X 0212 and JIS X 0213 Plane 2 don't have
  39. overlapped by each other, it doesn't bother standard conformations
  40. (and JIS X 0213 Plane 2 is intended to use so.) On encoding
  41. sessions, the codec will try to encode kanji characters in this
  42. order:
  43. JIS X 0213 Plane 1 -> JIS X 0213 Plane 2 -> JIS X 0212
  44. 4) euc-jp codec
  45. The euc-jp codec is a compatibility instance on these points:
  46. - U+FF3C FULLWIDTH REVERSE SOLIDUS is mapped to EUC-JP A1C0 (vice versa)
  47. - U+00A5 YEN SIGN is mapped to EUC-JP 0x5c. (one way)
  48. - U+203E OVERLINE is mapped to EUC-JP 0x7e. (one way)
  49. 5) shift-jis codec
  50. The shift-jis codec is mapping 0x20-0x7e area to U+20-U+7E directly
  51. instead of using JIS X 0201 for compatibility. The differences are:
  52. - U+005C REVERSE SOLIDUS is mapped to SHIFT-JIS 0x5c.
  53. - U+007E TILDE is mapped to SHIFT-JIS 0x7e.
  54. - U+FF3C FULL-WIDTH REVERSE SOLIDUS is mapped to SHIFT-JIS 815f.