Encode::CNMap
=================
Enhanced Chinese encodings with Simplified-Traditional auto-mapping

INSTALLATION
To install this module type the following:
  perl Makefile.PL
  make
  make test
  make install
  enc2xs -C       # optional; updates Encode.pm's on-demand loading DB

DEPENDENCIES
This module requires perl version 5.8.0 or later.

SYNOPSIS
   use Encode;
   use Encode::CNMap;
   no warnings;  # disable utf8 output warning
   my $data;

   $data = "中華中华";
   printf "Mix [GBK]  %s\n", $data;
   printf "   -> Simp[GB]   %s\n", simp_to_gb( $data );
   printf "   -> Trad[Big5] %s\n", simp_to_b5( $data );
   printf "   -> Mix [utf8] %s\n", simp_to_utf8( $data );
   printf "   -> Simp[utf8] %s\n", simp_to_simputf8( $data );
   printf "   -> Trad[utf8] %s\n", simp_to_tradutf8( $data );

   $data = "い地い地";
   printf "Trad[Big5] %s\n", $data;
   printf "   -> Simp[GB]   %s\n", trad_to_gb( $data );
   printf "   -> Mix [GBK]  %s\n", trad_to_gbk( $data );
   printf "   -> Mix [utf8] %s\n", trad_to_utf8( $data );
   printf "   -> Simp[utf8] %s\n", trad_to_simputf8( $data );
   printf "   -> Trad[utf8] %s\n", trad_to_tradutf8( $data );

   $data = Encode::decode("gbk", "中華中华");
   printf "Mix [utf8] %s\n", $data;
   printf "   -> Simp[GB]   %s\n", utf8_to_gb( $data );
   printf "   -> Mix [GBK]  %s\n", utf8_to_gbk( $data );
   printf "   -> Trad[Big5] %s\n", utf8_to_b5( $data );
   printf "   -> Mix [utf8] %s\n", utf8_to_utf8( $data );
   printf "   -> Simp[utf8] %s\n", utf8_to_simputf8( $data );
   printf "   -> Trad[utf8] %s\n", utf8_to_tradutf8( $data );

   cnmap "-command" [ *inputfile* ...] > *outputfile*
   cnmapdir "-command" *inputdir/file* *outputdir/file*

   cnmap -h
   cnmap -s2b5 gbk.txt > big5.txt
   cnmap -s2gb gbk.txt > gb.txt
   cnmap -s2c gbk.txt > utf8.txt
   cnmap -s2cgb gbk.txt > utf8-cnsimp.txt
   cnmap -s2cb5 gbk.txt > utf8-cntrad.txt
   cnmap -t2gb big5.txt > gb.txt
   cnmap -t2gbk big5.txt > gbk.txt
   cnmap -t2c big5.txt > utf8.txt
   cnmap -t2cgb big5.txt > utf8-cnsimp.txt
   cnmap -t2cb5 big5.txt > utf8-cntrad.txt
   cnmap -u2b5 utf8.txt > big5.txt
   cnmap -u2gb utf8.txt > gb.txt
   cnmap -u2gbk utf8.txt > gbk.txt
   cnmap -u2cgb utf8.txt > utf8-cnsimp.txt
   cnmap -u2cb5 utf8.txt > utf8-cntrad.txt
       cat gbk.txt | cnmap -s2gb | more

   cnmapdir -h
   cnmapdir -s2b5 gbkdir big5dir
   cnmapdir -s2gb gbkdir gbdir
   cnmapdir -s2c gbkdir utf8dir
   cnmapdir -s2cgb gbkdir utf8-cnsimp-dir
   cnmapdir -s2cb5 gbkdir utf8-cntrad-dir
   cnmapdir -t2gb big5dir gbdir
   cnmapdir -t2gbk big5dir gbkdir
   cnmapdir -t2c big5dir utf8dir
   cnmapdir -t2cgb big5dir utf8-cnsimp-dir
   cnmapdir -t2cb5 big5dir utf8-cntrad-dir
   cnmapdir -u2b5 utf8dir big5dir
   cnmapdir -u2gb utf8dir gbdir
   cnmapdir -u2gbk utf8dir gbkdir
   cnmapdir -u2cgb utf8dir utf8-cnsimp-dir
   cnmapdir -u2cb5 utf8dir utf8-cntrad-dir

DESCRIPTION
   This module implements China-based Chinese charset encodings.
   Encodings supported are as follows.

     Canonical   Alias     Description
   -------------------------------------------------------------------
     gb2312-simp           Enhanced GB2312 simplified chinese encoding
     big5-trad             Enhanced Big5 traditional chinese encoding
   -------------------------------------------------------------------

   To find how to use this module in detail, see Encode.

   cnmapwx is a GUI interface to cnmap and cnmapdir. Binary distribution
   for Microsoft Windows can be down from http://bookbot.sourceforge.net/

BUGS, REQUESTS, COMMENTS
   Please report any requests, suggestions or bugs via
   http://bookbot.sourceforge.net/
   http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Encode-CNMap

COPYRIGHT AND LICENCE
   Copyright 2003-2004 Qing-Jie Zhou <[email protected]>
   This library is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.