Integrate mainline (Win2k/MinGW all ok except threads/t/end.t)
[p5sagit/p5-mst-13.2.git] / ext / Encode / CN / CN.pm
index 185c0cf..12a9fd3 100644 (file)
@@ -1,11 +1,14 @@
 package Encode::CN;
-our $VERSION = '0.02';
+our $VERSION = do { my @r = (q$Revision: 0.94 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
 
 use Encode;
 use Encode::CN::HZ;
 use XSLoader;
 XSLoader::load('Encode::CN',$VERSION);
 
+Encode::define_alias( qr/euc.*cn$/i     => '"euc-cn"' );
+Encode::define_alias( qr/cn.*euc/i      => '"euc-cn"' );
+
 1;
 __END__
 =head1 NAME
@@ -14,21 +17,26 @@ Encode::CN - China-based Chinese Encodings
 
 =head1 SYNOPSIS
 
-    use Encode 'encode'; 
+    use Encode qw/encode decode/; 
     $euc_cn = encode("euc-cn", $utf8);   # loads Encode::CN implicitly
-    $utf8   = encode("euc-cn", $euc_cn); # ditto
+    $utf8   = decode("euc-cn", $euc_cn); # ditto
 
 =head1 DESCRIPTION
 
 This module implements China-based Chinese charset encodings.
 Encodings supported are as follows.
 
-  euc-cn       EUC (Extended Unix Character)
-  gb2312       The raw (low-bit) GB2312 character map
-  gb12345      Traditional chinese counterpart to GB2312 (raw)
-  iso-ir-165   GB2312 + GB6345 + GB8565 + additions
-  cp936                Code Page 936, also known as GBK (Extended GuoBiao)
-  hz           7-bit escaped GB2312 encoding
+  Canonical   Alias            Description
+  --------------------------------------------------------------------
+  euc-cn      /euc.*cn$/i      EUC (Extended Unix Character)
+             /cn.*euc$/i
+  gb2312                       The raw (low-bit) GB2312 character map
+  gb12345                      Traditional chinese counterpart to 
+                               GB2312 (raw)
+  iso-ir-165                   GB2312 + GB6345 + GB8565 + additions
+  cp936                                Code Page 936, also known as GBK 
+                               (Extended GuoBiao)
+  hz                           7-bit escaped GB2312 encoding
 
 To find how to use this module in detail, see L<Encode>.