Upgrade to Encode 1.42, from Dan Kogai.
[p5sagit/p5-mst-13.2.git] / ext / Encode / TW / TW.pm
CommitLineData
0e567a6c 1package Encode::TW;
071db25d 2BEGIN {
3 if (ord("A") == 193) {
4 die "Encode::TW not supported on EBCDIC\n";
5 }
6}
b2704119 7our $VERSION = do { my @r = (q$Revision: 1.21 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
c0d88b76 8
9use Encode;
0e567a6c 10use XSLoader;
b2704119 11XSLoader::load(__PACKAGE__,$VERSION);
0e567a6c 12
131;
14__END__
67d7b5ef 15
b2729934 16=head1 NAME
17
18Encode::TW - Taiwan-based Chinese Encodings
19
20=head1 SYNOPSIS
21
1b2c56c8 22 use Encode qw/encode decode/;
2b217bf7 23 $big5 = encode("big5", $utf8); # loads Encode::TW implicitly
ee981de6 24 $utf8 = decode("big5", $big5); # ditto
b2729934 25
26=head1 DESCRIPTION
27
28This module implements Taiwan-based Chinese charset encodings.
29Encodings supported are as follows.
30
1b2c56c8 31 Canonical Alias Description
32 --------------------------------------------------------------------
67d7b5ef 33 big5 /\bbig-?5$/i The original Big5 encoding
34 big5-hkscs /\bbig5-hk(scs)?$/i
35 Big5 plus Cantonese characters in
1b2c56c8 36 Hong Kong
a999c27c 37 MacChineseSimp Big5 + Apple Vendor Mappings
1b2c56c8 38 cp950 Code Page 950
a999c27c 39 = Big5 + Microsoft vendor mappings
5129552c 40 --------------------------------------------------------------------
41
b2729934 42To find how to use this module in detail, see L<Encode>.
43
44=head1 NOTES
45
46Due to size concerns, C<EUC-TW> (Extended Unix Character) and C<BIG5PLUS>
47(CMEX's Big5+) are distributed separately on CPAN, under the name
48L<Encode::HanExtra>. That module also contains extra China-based encodings.
49
50=head1 BUGS
51
52The C<CNS11643> encoding files are not complete (only the first two planes,
53C<11643-1> and C<11643-2>, exist in the distribution). For common CNS11643
54manipulation, please use C<EUC-TW> in L<Encode::HanExtra>, which contains
55plane 1-7.
56
57ASCII part (0x00-0x7f) is preserved for all encodings, even though it
58conflicts with mappings by the Unicode Consortium. See
59
a63c962f 60L<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
b2729934 61
62to find why it is implemented that way.
63
64=head1 SEE ALSO
65
67d7b5ef 66L<Encode>,L<Encode::CJKguide>
b2729934 67
68=cut