Commit | Line | Data |
0e567a6c |
1 | package Encode::TW; |
d6b7ef86 |
2 | our $VERSION = do { my @r = (q$Revision: 0.94 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r }; |
c0d88b76 |
3 | |
4 | use Encode; |
0e567a6c |
5 | use XSLoader; |
6 | XSLoader::load('Encode::TW',$VERSION); |
7 | |
d6b7ef86 |
8 | Encode::define_alias( qr/big-?5$/i => '"big5"' ); |
9 | Encode::define_alias( qr/big5-hk(?:scs)?/i => '"big5-hkscs"' ); |
10 | |
0e567a6c |
11 | 1; |
12 | __END__ |
b2729934 |
13 | =head1 NAME |
14 | |
15 | Encode::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 | |
25 | This module implements Taiwan-based Chinese charset encodings. |
26 | Encodings 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 | |
36 | To find how to use this module in detail, see L<Encode>. |
37 | |
38 | =head1 NOTES |
39 | |
40 | Due to size concerns, C<EUC-TW> (Extended Unix Character) and C<BIG5PLUS> |
41 | (CMEX's Big5+) are distributed separately on CPAN, under the name |
42 | L<Encode::HanExtra>. That module also contains extra China-based encodings. |
43 | |
44 | =head1 BUGS |
45 | |
46 | The C<CNS11643> encoding files are not complete (only the first two planes, |
47 | C<11643-1> and C<11643-2>, exist in the distribution). For common CNS11643 |
48 | manipulation, please use C<EUC-TW> in L<Encode::HanExtra>, which contains |
49 | plane 1-7. |
50 | |
51 | ASCII part (0x00-0x7f) is preserved for all encodings, even though it |
52 | conflicts with mappings by the Unicode Consortium. See |
53 | |
54 | F<http://www.debian.or.jp/~kubota/unicode-symbols.html.en> |
55 | |
56 | to find why it is implemented that way. |
57 | |
58 | =head1 SEE ALSO |
59 | |
60 | L<Encode> |
61 | |
62 | =cut |