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