Upgrade to Encode 0.95, from Dan Kogai.
[p5sagit/p5-mst-13.2.git] / ext / Encode / CN / CN.pm
CommitLineData
0e567a6c 1package Encode::CN;
5d030b67 2our $VERSION = do { my @r = (q$Revision: 0.95 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
c0d88b76 3
4use Encode;
5use Encode::CN::HZ;
0e567a6c 6use XSLoader;
7XSLoader::load('Encode::CN',$VERSION);
8
fab31126 9Encode::define_alias( qr/euc.*cn$/i => '"euc-cn"' );
10Encode::define_alias( qr/cn.*euc/i => '"euc-cn"' );
11
5d030b67 12# Relocated from Encode.pm
13# CP936 doesn't have vendor-addon for GBK, so they're identical.
14Encode::define_alias( qr/^gbk$/i => '"cp936"');
15
0e567a6c 161;
17__END__
b2729934 18=head1 NAME
19
20Encode::CN - China-based Chinese Encodings
21
22=head1 SYNOPSIS
23
1b2c56c8 24 use Encode qw/encode decode/;
2b217bf7 25 $euc_cn = encode("euc-cn", $utf8); # loads Encode::CN implicitly
ee981de6 26 $utf8 = decode("euc-cn", $euc_cn); # ditto
b2729934 27
28=head1 DESCRIPTION
29
30This module implements China-based Chinese charset encodings.
31Encodings supported are as follows.
32
fab31126 33 Canonical Alias Description
34 --------------------------------------------------------------------
35 euc-cn /euc.*cn$/i EUC (Extended Unix Character)
36 /cn.*euc$/i
37 gb2312 The raw (low-bit) GB2312 character map
38 gb12345 Traditional chinese counterpart to
39 GB2312 (raw)
40 iso-ir-165 GB2312 + GB6345 + GB8565 + additions
41 cp936 Code Page 936, also known as GBK
42 (Extended GuoBiao)
43 hz 7-bit escaped GB2312 encoding
b2729934 44
45To find how to use this module in detail, see L<Encode>.
46
47=head1 NOTES
48
49Due to size concerns, C<GB 18030> (an extension to C<GBK>) is distributed
50separately on CPAN, under the name L<Encode::HanExtra>. That module
51also contains extra Taiwan-based encodings.
52
c0d88b76 53=head1 BUGS
b2729934 54
55ASCII part (0x00-0x7f) is preserved for all encodings, even though it
56conflicts with mappings by the Unicode Consortium. See
57
58F<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
59
60to find why it is implemented that way.
61
62=head1 SEE ALSO
63
64L<Encode>
65
66=cut