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