ext/Encode/TW/TW.pm

   1 package Encode::TW;
   2 use Encode;
   3 our $VERSION = '0.02';
   4 use XSLoader;
   5 XSLoader::load('Encode::TW',$VERSION);
   6
   7 1;
   8 __END__
   9 =head1 NAME
  10
  11 Encode::TW - Taiwan-based Chinese Encodings
  12
  13 =head1 SYNOPSIS
  14
  15     use Encode::CN;
  16     $big5 = encode("big5", $utf8);
  17     $utf8 = encode("big5", $big5);
  18
  19 =head1 DESCRIPTION
  20
  21 This module implements Taiwan-based Chinese charset encodings.
  22 Encodings supported are as follows.
  23
  24   big5          The original Big5 encoding
  25   big5-hkscs    Big5 plus Cantonese characters in Hong Kong
  26   cp950 Code Page 950 (Big5 + Microsoft vendor mappings)
  27
  28 To find how to use this module in detail, see L<Encode>.
  29
  30 =head1 NOTES
  31
  32 Due to size concerns, C<EUC-TW> (Extended Unix Character) and C<BIG5PLUS>
  33 (CMEX's Big5+) are distributed separately on CPAN, under the name
  34 L<Encode::HanExtra>. That module also contains extra China-based encodings.
  35
  36 =head1 BUGS
  37
  38 The C<CNS11643> encoding files are not complete (only the first two planes,
  39 C<11643-1> and C<11643-2>, exist in the distribution). For common CNS11643
  40 manipulation, please use C<EUC-TW> in L<Encode::HanExtra>, which contains
  41 plane 1-7.
  42
  43 ASCII part (0x00-0x7f) is preserved for all encodings, even though it
  44 conflicts with mappings by the Unicode Consortium.  See
  45
  46 F<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
  47
  48 to find why it is implemented that way.
  49
  50 =head1 SEE ALSO
  51
  52 L<Encode>
  53
  54 =cut