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