home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 March / PCWorld_2003-03_cd.bin / Software / Topware / activeperl / ActivePerl / Perl / lib / Encode / TW.pm < prev    next >
Encoding:
Perl POD Document  |  2002-06-19  |  2.4 KB  |  79 lines
  1. package Encode::TW;
  2. BEGIN {
  3.     if (ord("A") == 193) {
  4.     die "Encode::TW not supported on EBCDIC\n";
  5.     }
  6. }
  7. our $VERSION = do { my @r = (q$Revision: 1.26 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
  8.  
  9. use Encode;
  10. use XSLoader;
  11. XSLoader::load(__PACKAGE__,$VERSION);
  12.  
  13. 1;
  14. __END__
  15.  
  16. =head1 NAME
  17.  
  18. Encode::TW - Taiwan-based Chinese Encodings
  19.  
  20. =head1 SYNOPSIS
  21.  
  22.     use Encode qw/encode decode/; 
  23.     $big5 = encode("big5", $utf8); # loads Encode::TW implicitly
  24.     $utf8 = decode("big5", $big5); # ditto
  25.  
  26. =head1 DESCRIPTION
  27.  
  28. This module implements tradition Chinese charset encodings as used
  29. in Taiwan and Hong Kong.
  30. Encodings supported are as follows.
  31.  
  32.   Canonical   Alias        Description
  33.   --------------------------------------------------------------------
  34.   big5-eten   /\bbig-?5$/i    Big5 encoding (with ETen extensions)
  35.           /\bbig5-?et(en)?$/i
  36.           /\btca-?big5$/i
  37.   big5-hkscs  /\bbig5-?hk(scs)?$/i
  38.               /\bhk(scs)?-?big5$/i
  39.                                 Big5 + Cantonese characters in Hong Kong
  40.   MacChineseTrad        Big5 + Apple Vendor Mappings
  41.   cp950                        Code Page 950 
  42.                                 = Big5 + Microsoft vendor mappings
  43.   --------------------------------------------------------------------
  44.  
  45. To find out how to use this module in detail, see L<Encode>.
  46.  
  47. =head1 NOTES
  48.  
  49. Due to size concerns, C<EUC-TW> (Extended Unix Character), C<CCCII>
  50. (Chinese Character Code for Information Interchange), C<BIG5PLUS>
  51. (CMEX's Big5+) and C<BIG5EXT> (CMEX's Big5e) are distributed separately
  52. on CPAN, under the name L<Encode::HanExtra>. That module also contains
  53. extra China-based encodings.
  54.  
  55. =head1 BUGS
  56.  
  57. Since the original C<big5> encoding (1984) is not supported anywhere
  58. (glibc and DOS-based systems uses C<big5> to mean C<big5-eten>; Microsoft
  59. uses C<big5> to mean C<cp950>), a conscious decision was made to alias
  60. C<big5> to C<big5-eten>, which is the de facto superset of the original
  61. big5.
  62.  
  63. The C<CNS11643> encoding files are not complete. For common C<CNS11643>
  64. manipulation, please use C<EUC-TW> in L<Encode::HanExtra>, which contains
  65. planes 1-7.
  66.  
  67. The ASCII region (0x00-0x7f) is preserved for all encodings, even
  68. though this conflicts with mappings by the Unicode Consortium.  See
  69.  
  70. L<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
  71.  
  72. to find out why it is implemented that way.
  73.  
  74. =head1 SEE ALSO
  75.  
  76. L<Encode>
  77.  
  78. =cut
  79.