Add CJK READMEs from Autrijus Tang, Dan Kogai, and
authorJarkko Hietaniemi <jhi@iki.fi>
Tue, 16 Apr 2002 04:31:49 +0000 (04:31 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Tue, 16 Apr 2002 04:31:49 +0000 (04:31 +0000)
Jungshik Shin.  Regen toc.

p4raw-id: //depot/perl@15944

MANIFEST
README.cn [new file with mode: 0644]
README.jp [new file with mode: 0644]
README.ko [new file with mode: 0644]
README.tw [new file with mode: 0644]
pod/buildtoc.PL
pod/perl.pod
pod/perltoc.pod

index 6bd5646..6a4044e 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -2192,6 +2192,10 @@ README.apollo            Notes about Apollo DomainOS port
 README.beos            Notes about BeOS port
 README.bs2000          Notes about BS2000 POSIX port
 README.ce              Notes about WinCE port
+README.cn              About using Perl and Simplified Chinese
+README.jp              About using Perl and Japanese
+README.ko              About using Perl and Korean
+README.tw              About using Perl and Traditional Chinese
 README.cygwin          Notes about Cygwin port
 README.dgux            Notes about DG/UX port
 README.dos             Notes about DOS/DJGPP port
diff --git a/README.cn b/README.cn
new file mode 100644 (file)
index 0000000..eb7f7a9
--- /dev/null
+++ b/README.cn
@@ -0,0 +1,139 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see perlpod manpage) which is
+specially designed to be readable as is.
+
+The following documentation is written in EUC-CN encoding.
+
+?��?����һ�������ֱ༭�����������ĵ�, �������������ص�ע���ַ�. ������
+������ POD (�����ĵ���ʽ) д��; ���ָ�ʽ��Ϊ����?���ֱ�Ӷ�ȡ���ر����?
+��. ���ڴ˸�ʽ�Ľ�һ����Ѷ, ���ο� perlpod �����ĵ�.
+
+=head1 NAME
+
+perlcn - �������� Perl ָ��
+
+=head1 DESCRIPTION
+
+��ӭ���� Perl ������!
+
+�� 5.8.0 �濪ʼ, Perl �߱����꾡�� Unicode (ͳһ��) ֧Ԯ, Ҳ����֧Ԯ��
+����������ϵ�����ı��뷽ʽ; CJK (��?պ?) �������е�һ����. Unicode ��
+�����Եı�׼, ��ͼ�������������е��ַ�: ��������, ��������, �Լ����߼�
+��һ�� (ϣ����, ��������, ��������, ϣ������, ӡ����, ӡ�ذ���, �ȵ�).
+��Ҳ?����˶�����ҵϵͳ��ƽ�? (?? PC ��������).
+
+Perl ������ Unicode ���в���. ����ʾ Perl �ڲ����ִ����Ͽ��� Unicode
+��ʾ, Perl �ĺ�ʽ������ (��?��?����ʾʽ�ȶ�) Ҳ�ܶ� Unicode ���в���.
+����?뼰�����?, Ϊ�˴����� Unicode ֮ǰ�ı��뷽ʽ����������, Perl �ṩ
+�ˡ�Encode������ģ��, ����?������׵ض�ȡ��д�����еı������?.
+
+Encode ����ģ��֧Ԯ���м������ĵı��뷽ʽ:
+
+    euc-cn     Unix �����ַ���, Ҳ�����׳ƵĹ�����
+    gb2312     δ�������� (�ͱ���) GB2312 �ַ���
+    gb12345    δ���������й��÷������ı���
+    iso-ir-165 GB2312 + GB6345 + GB8565 + �����ַ�
+    cp936      ����ҳ 936, Ҳ��Ϊ GBK (����������)
+    hz         7 �����ݳ�ʽ GB2312 ����
+
+������˵, �� euc-cn �����ĵ���ת�� Unicode, ������?�����ָ�?:
+
+    perl -Mencoding=euc-cn,STDOUT,utf8 -pe1 < file.euc-cn > file.utf8
+
+Perl Ҳ�ڸ��ˡ�piconv��, һ֧��?��? Perl д�ɵ��ַ�ת�����߳���, �÷�
+?��?:
+
+    piconv -f euc-cn -t utf8 < file.euc-cn > file.utf8
+    piconv -f utf8 -t euc-cn < file.utf8 > file.euc-cn
+
+����, ���� encoding ģ��, ����������д�����ַ�Ϊ��λ�ij�����, ?������?:
+
+    #!/usr/bin/env perl
+    # ���� euc-cn �ִ�����; ��׼����?뼰��׼���������? euc-cn ����
+    use encoding 'euc-cn', STDIN => 'euc-cn',
+                          STDOUT => 'euc-cn', STDERR => 'euc-cn';
+
+    print length("����");           #  2 (˫���ű�ʾ�ַ�)
+    print length('����');           #  4 (�����ű�ʾ�ֽ�)
+    print index("׻׻�̻�", "�׻�"); # -1 (�����������ִ�)
+    print index('׻׻�̻�', '�׻�'); #  1 (�ӵڶ����ֽڿ�ʼ)
+
+=head2 ���������ı���
+
+?��?��Ҫ���������ı���, ���Դ� CPAN (L<http://www.cpan.org/>) ����
+Encode::HanExtra ģ��. ��Ŀǰ�ṩ���б��뷽ʽ:
+
+    gb18030    �������Ĺ�����, ������������
+
+����, Encode::HanConvert ģ�����ṩ�˼���ת���õ����ֱ���:
+
+    gbk-trad   GBK ���������� Unicode �������Ļ�ת
+    big5-simp  Big5 ���������� Unicode �������Ļ�ת
+
+?����? GBK �� Big5 ֮�以ת, ���ο���ģ���ڸ��� b2g.pl �� g2b.pl ��
+֧����.
+
+=head2 ��һ������Ѷ
+
+���ο� Perl �ڸ��Ĵ���˵���ĵ� (����?������?��д��) , ��ѧϰ��������
+Perl ��֪ʶ, �Լ� Unicode ��ʹ�÷�ʽ. ����, �ⲿ����Դ�൱�ḻ:
+
+=head2 �ṩ Perl ��Դ����ַ
+
+=over 4
+
+=item L<http://www.perl.com/>
+
+Perl ����ҳ (��ŷ������˾ά��)
+
+=item L<http://www.cpan.org/>
+
+Perl �ۺϵ����� (Comprehensive Perl Archive Network)
+
+=item L<http://lists.perl.org/>
+
+Perl �ʵ���̳һ��
+
+=back
+
+=head2 ѧϰ Perl ����ַ
+
+=over 4
+
+=item L<http://www.oreilly.com.cn/html/perl.html>
+
+�������İ���ŷ���� Perl ����
+
+=back
+
+=head2 Perl ʹ���߼���
+
+=over 4
+
+=item L<http://www.pm.org/groups/asia.shtml#China>
+
+�й� Perl �ƹ���һ��
+
+=back
+
+=head2 Unicode ������ַ
+
+=over 4
+
+=item L<http://www.unicode.org/>
+
+Unicode ѧ��ѧ�� (Unicode ��׼���ƶ���)
+
+=item L<http://www.cl.cam.ac.uk/%7Emgk25/unicode.html>
+
+Unix/Linux �ϵ� UTF-8 �� Unicode ������
+
+=back
+
+=head1 AUTHORS
+
+Jarkko Hietaniemi E<lt>jhi@iki.fiE<gt>
+
+���ں� E<lt>autrijus@autrijus.orgE<gt>
+
+=cut
diff --git a/README.jp b/README.jp
new file mode 100644 (file)
index 0000000..1a58765
--- /dev/null
+++ b/README.jp
@@ -0,0 +1,200 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see perlpod manpage) which is
+specially designed to be readable as is.
+
+The following documentation is written in FOO encoding.
+
+=head1 NAME
+
+perljp - ���ܸ� Perl ������
+
+=head1 ����
+
+�褦���� Perl ��!
+
+Perl 5.8.0 ���ꡢUnicode���ݡ��Ȥ������˶������졢���η��̥��ƥ�ʸ���ʳ���ʸ���ɤΥ��ݡ��Ȥ� CJK (�����졢���ܸ졢�ϥ󥰥�)���ޤ��Ʋä����ޤ�����Unicode����������ʸ�������Ĥ�ʸ���ɤǰ������Ȥ��ܻؤ���ɸ�൬�ʤǤ��ꡢ�줫�������Ϥ��ޤ����δ֤�ʸ���ʥ��ꥷ��ʸ���꡼��ʸ�����ӥ�ʸ�����إ֥饤ʸ�����ǥ�����ʥ�����ʸ�����ʤɤʤɡˤ䡢�����ޤǤ�OS�٥��������ȼ��������Ƥ���ʸ��(PC������Macintosh)�����Ǥ˴ޤޤ��Ƥ��ޤ���
+
+Perl ���Ȥ� Unicode ��ư��ޤ���Perl �������ץ�����ʸ�������ƥ���������ɽ���� Unicode �������Ȥ��Ƥ��ޤ��������������ϤΤ����ˤϡ������ޤǻȤ����Ƥ������ޤ��ޤ�ʸ���ɤ��б������⥸�塼�롢�� Encode �פ�ɸ��������Ƥ��ꡢUnicode �Ȥ�������ʸ���ɤ������Ѵ�����ñ�˹Ԥ����褦�ˤʤäƤ��ޤ���
+
+�������� Encode �����ݡ��Ȥ���ʸ���ɤϰʲ��ΤȤ����Ǥ���
+
+  7bit-jis      AdobeStandardEncoding AdobeSymbol       AdobeZdingbat
+  ascii             big5              big5-hkscs        cp1006
+  cp1026            cp1047            cp1250            cp1251
+  cp1252            cp1253            cp1254            cp1255
+  cp1256            cp1257            cp1258            cp37
+  cp424             cp437             cp500             cp737
+  cp775             cp850             cp852             cp855
+  cp856             cp857             cp860             cp861
+  cp862             cp863             cp864             cp865
+  cp866             cp869             cp874             cp875
+  cp932             cp936             cp949             cp950
+  dingbats          euc-cn            euc-jp            euc-kr
+  gb12345-raw       gb2312-raw        gsm0338           hp-roman8
+  hz                iso-2022-jp       iso-2022-jp-1     iso-8859-1
+  iso-8859-10       iso-8859-11       iso-8859-13       iso-8859-14
+  iso-8859-15       iso-8859-16       iso-8859-2        iso-8859-3
+  iso-8859-4        iso-8859-5        iso-8859-6        iso-8859-7
+  iso-8859-8        iso-8859-9        iso-ir-165        jis0201-raw
+  jis0208-raw       jis0212-raw       johab             koi8-f
+  koi8-r            koi8-u            ksc5601-raw       MacArabic
+  MacCentralEurRoman  MacChineseSimp    MacChineseTrad    MacCroatian
+  MacCyrillic       MacDingbats       MacFarsi          MacGreek
+  MacHebrew         MacIcelandic      MacJapanese       MacKorean
+  MacRoman          MacRomanian       MacRumanian       MacSami
+  MacSymbol         MacThai           MacTurkish        MacUkrainian
+  nextstep          posix-bc          shiftjis          symbol
+  UCS-2BE           UCS-2LE           UTF-16            UTF-16BE
+  UTF-16LE          UTF-32            UTF-32BE          UTF-32LE
+  utf8              viscii                              
+
+(��114����)
+
+�㤨�С�ʸ����FOO�Υե�������UTF-8���Ѵ������ˤϡ��ʲ��Τ褦�ˤ��ޤ���
+
+    perl -Mencoding=FOO,STDOUT,utf8 -pe1 < file.FOO > file.utf8
+
+�ޤ���Perl�ˤϡ�������Perl�ǽ񤫤줿ʸ�����Ѵ��桼�ƥ����ƥ���piconv����°���Ƥ����Τǡ��ʲ��Τ褦�ˤ��뤳�Ȥ��Ǥ��ޤ���
+
+   piconv -f FOO -t utf8 < file.FOO > file.utf8
+   piconv -f utf8 -t FOO < file.utf8 > file.FOO
+
+=head2 About (jcode.pl|Jcode.pm|JPerl)
+
+5.8�����Ρ��������ץȤ�EUC-JP�Ǥ����Х��ƥ��������ϰ������Ȥ��Ǥ��ޤ������ޤ��������Ϥ򰷤��⥸�塼���Ȥ��Ƥ�Jcode.pm��( http://openlab.jp/Jcode/ )��perl4�ѤΥ桼�ƥ����ƥ��Ȥ��Ƥ�jcode.pl( http://srekcah.org/jcode/ )�����줾��¸�ߤ������ܸ��ΰ�����CGI�Ǥ褯���Ѥ����Ƥ��뤳�Ȥ���¸�������⾯�ʤ��ʤ����Ȼפ����ޤ��������������ܸ��ˤ�������ɽ���򤦤ޤ��������Ȥ��Բ�ǽ�Ǥ�����
+
+5.005������Perl�ˤϡ����ܸ����ò����������饤���ǡ�Jperl��¸�ߤ��ޤ���( http://homepage2.nifty.com/kipp/perl/jperl/index.html )���ޤ���MacOS 9.x/Classic�Ѥ�Perl��MacPerl�����ܸ��Ǥ�MacJPerl�Ȥ���¸�ߤ��Ƥޤ�����( http://world.std.com/~habilis/macjperl/ ).�������Ǥ�ʸ���ɤȤ���EUC-JP�˲ä�Shift_JIS�⤽�Τޤް������Ȥ��Ǥ����ޤ����ܸ��ˤ�������ɽ���򰷤����Ȥ���ǽ�Ǥ�����
+
+Perl5.8�Ǥϡ��������ε�ǽ�����٤�Perl���Τ����Ǽ¸��Ǥ������ˡ����ܸ��Τߤʤ餺�嵭114��ʸ���ɤ򤹤٤ơ�������Ʊ���˰������Ȥ��Ǥ��ޤ��������ˡ�CPAN�ʤɤ��鿷����ʸ�����ѤΥ⥸�塼�������ꤹ�뤳�Ȥ���ñ�ˤǤ����褦�ˤʤäƤ��ޤ���
+
+=over 4
+
+=item��������
+
+�ʲ������Ϥ��Ť���Shift_JIS�����Ϥ�EUC-JP���Ѵ����ƽ��Ϥ��ޤ���
+
+  # jcode.pl
+  require "jcode.pl";
+  while(<>){
+    jcode::convert(*_, 'euc', 'sjis);
+    print;
+  }
+  # Jcode.pm
+  use Jcode;
+  while(<>){
+       print Jcode->new($_, 'sjis')->euc;
+  }
+  # Perl 5.8
+  use Encode;
+  while(<>){
+    from_to($_, 'shiftjis', 'euc-jp');
+    print;
+  }
+  # Perl 5.8 - encoding �����Ѥ���
+  use encoding 'euc-jp', STDIN=>'shiftjis'
+  while(<>){
+       print;
+  }
+
+=item Jperl �ߴ��������ץ�
+
+ ��������"shebang"���ѹ����������ǡ�Jperl�Ѥ�script�ΤۤȤ��ɤ��ѹ��ʤ������Ѳ�ǽ���Ȼפ����ޤ���
+   #!/path/to/jperl
+   ��
+   #!/path/to/perl -Mencoding=euc-jp
+   
+ �ܤ����� perldoc encoding �򻲾Ȥ��Ƥ���������
+
+=back
+
+=head2 �����˾ܤ���
+
+Perl�ˤ������ʻ�������°���Ƥ��ꡢPerl�ο���ǽ��Unicode���ݡ��ȡ�������Encode�⥸�塼���λ���ˡ�ʤɤ��٤������夵���Ƥ��ޤ��ʻ�ǰ�ʤ��顢�ۤȤ��ɱѸ��ǤϤ����ޤ����ˡ��ʲ��Υ��ޥ��ɤǤ������ΰ���������뤳�Ȥ���ǽ�Ǥ���
+
+  perldoc perlunicode # Perl��Unicode���ݡ�������
+  perldoc Encode      # Encode�⥸�塼���˴ؤ���
+  perldoc Encode::JP  # �������ܸ�ʸ���ɤ˴ؤ���
+
+=head2 Perl���̤˴ؤ��� URL
+
+=over 4
+
+=item L<http://www.perl.com/>
+
+Perl �ۡ����ڡ��� (O'Reilly and Associates)
+
+=item L<http://www.cpan.org/>
+
+CPAN (Comprehensive Perl Archive Network)
+
+=item L<http://lists.perl.org/>
+
+Perl �᡼���󥰥ꥹ�Ƚ�
+
+=back
+
+=head2 Perl�ν�������Ω�� URL
+
+=over 4
+
+=item L<http://www.oreilly.com.tw/chinese/>
+
+O'Reilly �Ҥ�Perl��Ϣ����(���λ�������)
+
+=item L<http://www.oreilly.com.cn/chinese/>
+
+O'Reilly �Ҥ�Perl��Ϣ����(���λ�������)
+
+=item L<http://www.oreilly.co.jp/catalog.htm>
+
+���饤�꡼�Ҥ�Perl��Ϣ����(���ܸ�)
+
+=back
+
+=head2 Perl �桼�������롼��
+
+=over 4
+
+=item L<http://www.pm.org/groups/asia.shtml#China>
+
+���������ڿ�̱���¹���
+
+=item L<http://www.pm.org/groups/asia.shtml#Japan>
+
+����
+
+=item L<http://www.pm.org/groups/asia.shtml#Korea%20(Republic%20of)>
+
+�ڹ�������̱����
+
+=item L<http://www.pm.org/groups/asia.shtml#Taiwan>
+
+���ѡ�����̱����
+
+=back
+
+=head2 Unicode��Ϣ��URL
+
+=over 4
+
+=item L<http://www.unicode.org/>
+
+Unicode ���󥽡������� (Unicode���ʤ���������)
+
+=item L<http://www.cl.cam.ac.uk/%7Emgk25/unicode.html>
+
+UTF-8 and Unicode FAQ for Unix/Linux
+
+=item L<http://kldp.org/Translations/html/UTF8-Unicode-KLDP/UTF8-Unicode-KLDP.html>
+
+UTF-8 and Unicode FAQ for Unix/Linux (�ϥ󥰥���)
+
+=back
+
+=head1 AUTHORS
+
+Jarkko Hietaniemi E<lt>jhi@iki.fiE<gt>
+Dan Kogai (��������) E<lt>dankogai@dan.co.jpE<gt>
+
+=cut
diff --git a/README.ko b/README.ko
new file mode 100644 (file)
index 0000000..e83bfc2
--- /dev/null
+++ b/README.ko
@@ -0,0 +1,179 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see perlpod manpage) which is
+specially designed to be readable as is.
+
+This file is in Korean encoded in EUC-KR. 
+
+�� ������ perldoc�� �Ἥ ���� �ʰ� ���� ���� ���쿡�� �� �κ���
+������ ǥ���ϱ� ���� ���� =head, =item, 'L' ���� �����Ͻʽÿ�.
+�� ������ ���� perldoc�� ���� �ʰ� �������� �дµ� �� ������
+���� POD �������� ¥�� �ֽ��ϴ�.  �� �ڼ��� ���� perlpod
+�Ŵ����� �����Ͻʽÿ�. 
+
+
+=head1 NAME
+
+perlko - Perl�� �ѱ��� ���ڵ�
+
+=head1 DESCRIPTION
+
+Perl�� ���迡 ���� ���� ȯ���մϴ� !
+
+Starting for Perl release 5.8.0 Perl has extensive support for Unicode
+and as a part of that, extensive support for non-Latin characters
+encodings, including the CJK (Chinese-Japanese Korean).  Unicode is an
+international standard that aims to include all of world's
+characters: Western, Eastern, and everything in between (Greek,
+Cyrillic, Arabic, Hebrew, Indic, Amerindian, and so on), and
+encodings of various operating system platforms (PC and MacIntosh).
+
+Perl�� 5.8.0 ������� �����ڵ�/ISO 10646�� ���� �������� ���� ������
+������ �ֽ��ϴ�. �����ڵ� ������ ��ȯ���� �������� ������ ���� ��������
+�����ڵ� ������ ���� �־��� ���ݵ� �θ� ���̰� �ִ� ������ ���ڵ���
+�����մϴ�.  �����ڵ��� �� ���迡�� ���̴� ���� ��� ���� ǥ�� ü�� -
+������ ��ƾ ���ĺ�, Ű�� ���ĺ�, �׸��� ���ĺ�, �ε��� ���� �ƽþ���
+������ ��ũ��Ʈ �迭, �ƶ�, ���긮, �������� ����, �ѱ����� �ѱ�,
+�Ϻ����� ����, �Ϲ� �ε����� ǥ�� ü�� ��- �����ϴ� ���� ��ǥ�� �ϰ�
+�ֱ� ������ ������ ���̴�  �� ���� �� ���� �׸��� � ü�迡 ������
+���� ���հ� ���ڵ��� ���� �����ϰ� �ֽ��ϴ�.
+
+
+Perl�� ���������� �����ڵ带 ���� ǥ���� ���� �����մϴ�. ���� ��ü������
+���ϸ� Perl ��ũ��Ʈ �ȿ���  UTF-8 ���ڿ��� �� �� �ְ�, 
+���� �Լ��� ������ (���� ����, ���Խ�, index, substr)�� ����Ʈ ����
+���� �����ڵ� ���� ������ �����մϴ�. (�� �ڼ��� ���� 
+perlunicode �Ŵ����� �����Ͻʽÿ�.) �����ڵ尡 �θ� ���޵DZ� ����
+�θ� ���̰� �־���, ������ �θ� ���̰� �ִ� ����/�� ��� ���ڵ�����
+�������� �ϰ� �̵� ���ڵ����� �� �����Ϳ� ������ �ٷ��� ���� ���� ����
+'Encode'��  �������ϴ�. �������� 'Encode'��  �Ἥ ������ ���ڵ� ������
+��ȯ�� ���� �� �� �ֽ��ϴ�.
+
+'Encode'�� ������ ���� �ѱ��� ���ڵ��� �����մϴ�.
+
+  euc-kr         : US-ASCII�� KS X 1001�� ���� ���� ��Ƽ����Ʈ ���ڵ�
+                   (���� �ϼ����̶��� �Ҹ�.) KS X 2901�� RFC 1557 ����.
+  cp949          : MS-Windows 9x/ME���� ���̴� Ȯ�� �ϼ���. 
+                   euc-kr�� 8,822���� �ѱ� ������ ���� ����. 
+                   alias�� uhc, windows-949, x-windows-949,
+                   ks_c_5601-1987. �� ������ �̸��� �������� ����
+                   �̸�������, Microsoft ��ǰ���� CP949�� �ǹ̷�
+                   ���̰� ����.
+  johab          : KS X 1001:1998 �η� 3���� ������ ������.
+                   ���� �����丮�� cp949�� ���������� US-ASCII,
+                   KS X 1001�� 8,822���� �ѱ� ������ ���� ����.
+
+  iso-2022-kr    : RFC 1557���� ������ �ѱ��� ���ͳ� ���� ��ȯ�� ���ڵ�����
+                   US-ASCII�� KS X 1001�� �����丮�� �ϴ� ������
+                   euc-kr�� ������ ���ڵ� ������ �ٸ�. 
+                   1997-8�� ������ �������� �� �̻� ���� ��ȯ�� ������
+                   ����.
+  ksc5601-raw    : KS X 1001(KS C 5601)�� GL(��, MSB�� 0���� �� ����)
+                   �� ������ ���� ���ڵ�. US-ASCII�� �������� �ʰ�
+                   �ܵ����� ���̴� ���� X11 ��� �۲� ���ڵ�
+                   (ksc5601.1987-0. '0'�� GL�� �ǹ���.)���� ���̴� ���� 
+                   �����ϰ��� ���� ����.
+
+���� ����, euc-kr ���ڵ����� �� ������ UTF-8�� ��ȯ�Ϸ��� ������
+���� �ϸ� �˴ϴ�. 
+
+
+    perl -Mencoding=euc-kr,STDOUT,utf8 -pe1  < file.euckr > file.utf8
+
+����ȯ�� ������ ���� �� �� �ֽ��ϴ�. 
+
+    perl -Mencoding=utf8,STDOUT,euc-kr -pe1  < file.utf8  > file.euckr
+
+�̷� ��ȯ�� ���� ���ϰ� �� �� �ֵ��� Encode ������ �Ἥ 
+�����ϰ� Perl�θ� ���� piconv�� Perl�� ���� �ֽ��ϴ�.
+�� �̸����� �� �� �ֵ��� piconv�� Unix�� �ִ� iconv��
+�𵨷� �� ���Դϴ�. �� �������� �Ʒ��� �����ϴ�.
+
+   piconv -f FOO -t utf8 < file.euckr > file.utf8
+   piconv -f utf8 -t FOO < file.utf8 > file.euckr
+
+��, 'encoding' ������ �Ἥ �ѱ��� ���ڵ��� ���鼭 ���� ����
+(����Ʈ ������ �ƴ϶�) ó���� ���� �� �� �ֽ��ϴ�.
+
+  #!/usr/local/bin/perl 
+
+  use encoding 'euc-kr', STDIN => 'euc-kr',
+                         STDOUT-> 'euc-kr', STDERR=>'euc-kr';
+
+  print length("����");        # 2  (ū ����ǥ�� ���� ���� ó���� ����)
+  print length('����');        # 4  (���� ����ǥ�� ����Ʈ ���� ó���� ����)
+  print index("�Ѱ�, �뵿��", "��");   # -1 ('��'�� ����)
+  print index('�Ѱ�, �뵿��', '��');   # 7 (8��°�� 9��° ����Ʈ�� '��'��
+                                            �ڵ尪�� ��ġ��.)
+
+
+=head2 �� �ڼ��� �˰� ������...
+
+Perl�� ��ġ�ϸ�  ������ �ڼ��� ������ ���� ���� ����, �� ������ ����
+Perl ���� �� �ƴ϶� �����ڵ� ����, Encode�� ������ � ���� ����
+���� �� �ֽ��ϴ�.  �������� �� ������ ���� ���� ������ ���� �ֽ��ϴ�.
+�� ���� �ܿ��� ������ ���� �ڷᰡ �ֽ��ϴ�. �� ������ ����
+������ ���� �ƴϰ� �Ϻ� ��ǥ���� �͸� ���� ���Դϴ�.
+
+
+=head2 Perl ���� �ڷ�
+
+=over 4
+
+=item L<http://www.perl.com/>          
+
+   O'Reilly�� Perl �� ������ 
+
+=item L<http://www.cpan.org/>
+
+       Comprehensive Perl Archive Network
+
+=item L<http://lists.perl.org/>        
+
+  Perl ���ϸ� ����Ʈ. ���� ����Ʈ ���
+  perl-unicode���� 'Encode'�� ���� ������.
+
+=back
+
+=head2 Perl�� �� ���� �����ϴµ� ������ �� �� �ִ� �ѱ��� ���� ����Ʈ
+
+=over 4
+
+=item L<http://www.oreilly.co.kr/perl/>
+  
+  O'Reilly���� ���� �ѱ��� Perl ���� ����
+
+=item L<http://www.perl.co.kr>
+
+  Perl�� ���õ� CGI, DB, ���� � ����  ���� �� ���� ����
+
+=back 
+
+=head2 �����ڵ� ���� �ڷ�
+
+=over 4
+
+=item L<http://www.unicode.org/>
+
+  �����ڵ� ���ҽþ�.  
+
+=item L<http://std.dkuug.dk/JTC1/SC2/WG2>
+
+�⺻������ Unicode�� ���� ISO ǥ����  ISO/IEC 10646 UCS(Universal
+Character Set)�� ������  ISO/IEC JTC1/SC2/WG2�� �� ������. 
+
+=item L<htp://www.cl.cam.ac.uk/~mgk25/unicode.html>
+
+  ���н�/���������� �����ڵ��� UTF-8 ���뿡 ���� ������(FAQ)
+
+=item L<http://kldp.org/Translations/html/UTF8-Unicode-KLDP/UTF8-Unicode-KLDP.html>
+
+  ���н�/���������� �����ڵ��� UTF-8 ���뿡 ���� ������(FAQ)��  �ѱ��� ����
+
+=back
+
+=head1 AUTHORS
+
+Jarkko Hietaniemi E<lt>jhi@iki.fiE<gt>
+������ E<lt>jshin@mailaps.org<gt>
+
+=cut
diff --git a/README.tw b/README.tw
new file mode 100644 (file)
index 0000000..02c0d4e
--- /dev/null
+++ b/README.tw
@@ -0,0 +1,145 @@
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see perlpod manpage) which is
+specially designed to be readable as is.
+
+The following documentation is written in Big5 encoding.
+
+�p�G�A�Τ@�몺���r�s�边�\���o������, �Щ����夤�_�S�����O�r��. �o����
+���O�H POD (²�������榡) �g��; �o�خ榡�O���F�����H����Ū���ӯS�O�]�p
+��. ���󦹮榡���i�@�B���T, �аѦ� perlpod �u�W����.
+
+=head1 NAME
+
+perltw - ���餤�� Perl ���n
+
+=head1 DESCRIPTION
+
+�w���Ө� Perl ���Ѧa!
+
+�q 5.8.0 ���}�l, Perl ���ƤF�Ժɪ� Unicode (�U���X) �䴩, �]�s�a�䴩�F
+�\�h�ԤB�y�t�H�~���s�X�覡; CJK (������) �K�O�䤤���@����. Unicode �O
+���کʪ��з�, �չϲ[�\�@�ɤW�Ҧ����r��: �����@��, �F���@��, �H�Ψ��̶�
+���@�� (��þ��, �ԧQ�Ȥ�, ���ԧB��, �ƧB�Ӥ�, �L�פ�, �L�a�w��, ����).
+���]�e�ǤF�h�ا@�~�t�λP���O (�p PC �γ�����).
+
+Perl �����H Unicode �i���ާ@. �o���� Perl �������r�����ƥi�� Unicode
+����, Perl ���禡�P���� (�Ҧp���W���ܦ�����) �]���� Unicode �i���ާ@.
+�b���J�ο��X��, ���F�B�z�H Unicode ���e���s�X�覡�x�s������, Perl ����
+�F�uEncode�v�o�ӼҲ�, �i�H���A�����aŪ���μg�J�¦����s�X����.
+
+Encode �����Ҳդ䴩�U�C���餤�媺�s�X�覡:
+
+    big5       �̪쪺 Big5 �s�X
+    big5-hkscs Big5 + �����~�r��
+    cp950      �r�X�� 950 (Big5 + �L�n�K�[���r��)
+
+�|�Ҩӻ�, �N Big5 �s�X���ɮ��ন Unicode, �������J�U�C���O:
+
+    perl -Mencoding=big5,STDOUT,utf8 -pe1 < file.big5 > file.utf8
+
+Perl �]�����F�upiconv�v, �@�䧹���H Perl �g�����r���ഫ�u���{��, �Ϊk
+�p�U:
+
+    piconv -f big5 -t utf8 < file.big5 > file.utf8
+    piconv -f utf8 -t big5 < file.utf8 > file.big5
+
+�t�~, �Q�� encoding �Ҳ�, �A�i�H�����g�X�H�r�Ŭ����쪺�{���X, �p�U�ҥ�:
+
+    #!/usr/bin/env perl
+    # �Ұ� big5 �r���ѪR; �зǿ��X�J�μзǿ��~���]�� big5 �s�X
+    use encoding 'big5', STDIN => 'big5',
+                        STDOUT => 'big5', STDERR => 'big5';
+
+    print length("�d�m");           #  2 (���޸����ܦr��)
+    print length('�d�m');           #  4 (���޸����ܦ줸��)
+    print index("�ναл�", "να"); # -1 (���]�t���l�r��)
+    print index('�ναл�', 'να'); #  1 (�q�ĤG�Ӧr�`�}�l)
+
+=head2 �B�~�������s�X
+
+�p�G�ݭn���h�������s�X, �i�H�q CPAN (L<http://www.cpan.org/>) �U��
+Encode::HanExtra �Ҳ�. ���ثe���ѤU�C�s�X�覡:
+
+    euc-tw     Unix �����r�Ŷ�, �]�t CNS11643 ���� 1-7
+    big5plus   �����Ʀ��Ƨ޳N���s�����|�� Big5+
+
+�t�~, Encode::HanConvert �Ҳիh���ѤF²�c�ഫ�Ϊ����ؽs�X:
+
+    big5-simp  Big5 ���餤���P Unicode ²�餤�夬��
+    gbk-trad   GBK ²�餤���P Unicode �c�餤�夬��
+
+�Y�Q�b GBK �P Big5 ��������, �аѦҸӼҲդ����� b2g.pl �P g2b.pl ��
+���{��.
+
+=head2 �i�@�B�����T
+
+�аѦ� Perl �������j�q�������� (�������O�έ^���g��) , �ӾDzߧ��h����
+Perl ������, �H�� Unicode ���ϥΤ覡. ���L, �~�����귽�۷��״I:
+
+=head2 ���� Perl �귽�����}
+
+=over 4
+
+=item L<http://www.perl.com/>
+
+Perl ������ (�Ѽڵ�§���q���@)
+
+=item L<http://www.cpan.org/>
+
+Perl ���X���ú� (Comprehensive Perl Archive Network)
+
+=item L<http://lists.perl.org/>
+
+Perl �l���׾¤@��
+
+=back
+
+=head2 �Dz� Perl �����}
+
+=over 4
+
+=item L<http://www.oreilly.com.tw/chinese/perl/index.html>
+
+���餤�媩���ڵ�§ Perl ����
+
+=item L<http://groups.google.com/groups?q=tw.bbs.comp.lang.perl>
+
+�O�W Perl �s�u�Q�װ� (�]�N�O�U�j BBS �� Perl �s�u��)
+
+=back
+
+=head2 Perl �ϥΪ̶��|
+
+=over 4
+
+=item L<http://www.pm.org/groups/asia.shtml#Taiwan>
+
+�O�W Perl ���s�դ@��
+
+=item L<http://irc.elixus.org/>
+
+���ߨ��u�W���ѫ�
+
+=back
+
+=head2 Unicode �������}
+
+=over 4
+
+=item L<http://www.unicode.org/>
+
+Unicode �dzN�Ƿ| (Unicode �зǪ����w��)
+
+=item L<http://www.cl.cam.ac.uk/%7Emgk25/unicode.html>
+
+Unix/Linux �W�� UTF-8 �� Unicode ���Ȱ�
+
+=back
+
+=head1 AUTHORS
+
+Jarkko Hietaniemi E<lt>jhi@iki.fiE<gt>
+
+���v�~ E<lt>autrijus@autrijus.orgE<gt>
+
+=cut
index b38bec5..413afd8 100644 (file)
@@ -90,6 +90,13 @@ if (-d "pod") {
     perlwin32           
           );
 
+@CJKPODS = qw(
+    perlcn
+    perljp
+    perlko
+    perltw
+          );
+
 @pods = 
   (
     qw(
@@ -199,13 +206,16 @@ if (-d "pod") {
 
     ),
 
-    @ARCHPODS
+    @ARCHPODS,
 
   );
 
 for (@ARCHPODS) { s/$/.pod/ }
 @ARCHPODS{@ARCHPODS} = ();
 
+for (@CJKPODS) { s/$/.pod/ }
+@CJKPODS{@CJKPODS} = ();
+
 for (@pods) { s/$/.pod/ }
 @pods{@pods} = ();
 @PODS{@PODS} = ();
@@ -232,6 +242,11 @@ die "$0: could not find the pod listing of perl.pod\n"
   unless @PERLPODS;
 @PERLPODS{@PERLPODS} = ();
 
+# Delete the CJK because we cannot mix their encodings.
+delete @PERLPODS{@CJKPODS};
+delete @PODS{@CJKPODS};
+delete @pods{@CJKPODS};
+
 # Cross-check against ourselves
 # Cross-check against the MANIFEST
 # Cross-check against the perl.pod
@@ -240,7 +255,7 @@ foreach my $i (sort keys %PODS) {
   warn "$0: $i exists but is unknown by buildtoc\n"
        unless exists $pods{$i};
   warn "$0: $i exists but is unknown by ../MANIFEST\n"
-       if !exists $MANIPODS{$i} && !exists $ARCHPODS{$i};
+       if !exists $MANIPODS{$i} && !exists $ARCHPODS{$i} && !exists $CJKPODS{$i};
   warn "$0: $i exists but is unknown by perl.pod\n"
        unless exists $PERLPODS{$i};
 }
index 2cac3f8..b751d0b 100644 (file)
@@ -136,6 +136,13 @@ For ease of access, the Perl manual has been split up into several sections.
     perl5005delta      Perl changes in version 5.005
     perl5004delta      Perl changes in version 5.004
 
+=head2 Language-Specific
+
+    perlcn             Perl for Simplified Chinese (in EUC-CN)
+    perljp             Perl for Japanese (in EUC-JP)
+    perlko             Perl for Korean (in EUC-KR)
+    perltw             Perl for Traditional Chinese (in Big5)
+
 =head2 Platform-Specific
 
     perlaix            Perl notes for AIX
index 2fe1c39..8325d43 100644 (file)
@@ -29,6 +29,8 @@ through to locate the proper section you're looking for.
 
 =item Miscellaneous
 
+=item Language-Specific
+
 =item Platform-Specific
 
 =back
@@ -2264,7 +2266,7 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =item Unicode Encodings
 
-=item Security Implications of Malformed UTF-8
+=item Security Implications of Unicode
 
 =item Unicode in Perl on EBCDIC
 
@@ -2276,6 +2278,16 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =item BUGS
 
+=over 4
+
+=item Interaction with locales
+
+=item Interaction with extensions
+
+=item speed
+
+=back
+
 =item SEE ALSO
 
 =back
@@ -2426,6 +2438,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Protecting Your Programs
 
+=item Unicode
+
 =back
 
 =item SEE ALSO
@@ -2717,8 +2731,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date:
-2002/02/21 14:49:15 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
+2002/04/07 18:46:13 $)
 
 =over 4
 
@@ -2764,8 +2778,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $,
-$Date: 2002/03/09 21:01:13 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.12 $,
+$Date: 2002/04/09 17:16:05 $)
 
 =over 4
 
@@ -2820,8 +2834,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
-19:29:52 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.18 $, $Date: 2002/04/09
+17:11:16 $)
 
 =over 4
 
@@ -2905,8 +2919,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11
-22:15:19 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.20 $, $Date: 2002/04/07
+18:46:13 $)
 
 =over 4
 
@@ -3122,8 +3136,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11
-22:25:25 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.15 $, $Date: 2002/04/12
+02:02:05 $)
 
 =over 4
 
@@ -3215,8 +3229,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31
-04:27:55 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.10 $, $Date: 2002/04/07
+18:32:57 $)
 
 =over 4
 
@@ -3282,8 +3296,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date:
-2002/01/31 04:27:55 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
+2002/03/26 15:48:32 $)
 
 =over 4
 
@@ -3489,7 +3503,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27
+=head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
 $)
 
 =over 4
@@ -3974,6 +3988,8 @@ C<t>, C<p>, C<n>, C<s>
 
 =item Creating New Variables
 
+GV_ADDMULTI, GV_ADDWARN
+
 =item Reference Counts and Mortality
 
 =item Stashes and Globs
@@ -4798,6 +4814,12 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Update auxiliary tools
 
+=item Create debugging macros
+
+=item truncate to the people
+
+=item Unicode in Filenames
+
 =back
 
 =item Recently done things
@@ -4918,10 +4940,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Unicode collation and normalization
 
-=item Create debugging macros
-
-=item truncate to the people
-
 =item pack/unpack tutorial
 
 =back
@@ -5119,6 +5137,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item PerlIO is Now The Default
 
+=item Restricted Hashes
+
 =item Safe Signals
 
 =item Unicode Overhaul
@@ -8416,7 +8436,7 @@ diagnostics
 
 =item USAGE
 
-use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =>
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
 I<ENCNAME_IN> ...] ;, no encoding;
 
 =item CAVEATS
@@ -8429,6 +8449,10 @@ I<ENCNAME_IN> ...] ;, no encoding;
 
 =back
 
+=item NON-ASCII Identifiers and Filter option
+
+use encoding I<ENCNAME> Filter=E<gt>1;
+
 =item EXAMPLE - Greekperl
 
 =item KNOWN PROBLEMS
@@ -10431,7 +10455,7 @@ C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
 =item p
 
 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
-C<perl>, C<perl_patchlevel>
+C<perl5>, C<perl>, C<perl_patchlevel>
 
 =item P
 
@@ -10501,7 +10525,7 @@ C<xlibpth>, C<xs_apiversion>
 
 =item y
 
-C<yacc>, C<yaccflags>
+C<yaccflags>
 
 =item z
 
@@ -11014,12 +11038,16 @@ Perl code
 
 =item PERL ENCODING API
 
-$bytes = encode(ENCODING, $string[, CHECK]), $string = decode(ENCODING,
-$bytes[, CHECK]), [$length =] from_to($string, FROM_ENCODING, TO_ENCODING[,
-CHECK])
+$octets  = encode(ENCODING, $string[, CHECK]), $string = decode(ENCODING,
+$octets[, CHECK]), [$length =] from_to($string, FROM_ENCODING, TO_ENCODING
+[,CHECK])
 
 =over 4
 
+=item UTF-8 / utf8
+
+$octets = encode_utf8($string);, $string = decode_utf8($octets [, CHECK]);
+
 =item Listing available encodings
 
 =item Defining Aliases
@@ -11030,16 +11058,6 @@ CHECK])
 
 =item Handling Malformed Data
 
-Scheme 1, Scheme 2, Other Schemes
-
-=over 4
-
-=item UTF-8 / utf8
-
-$bytes = encode_utf8($string);, $string = decode_utf8($bytes [, CHECK]);
-
-=back
-
 =item Defining Encodings
 
 =item Messing with Perl's Internals
@@ -11050,9 +11068,7 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
 
 =back
 
-=head2 Encode::10646_1, Encode::10656_1 -- for internal use only
-
-=head2 Encode::Alias - alias defintions to encodings
+=head2 Encode::Alias - alias definitions to encodings
 
 =over 4
 
@@ -11140,9 +11156,9 @@ reference, e.g.:
 
 =item SEE ALSO
 
-=back
+Scheme 1, Scheme 2, Other Schemes
 
-=head2 Encode::Internal -- for internal use only
+=back
 
 =head2 Encode::JP - Japanese Encodings
 
@@ -11162,13 +11178,9 @@ reference, e.g.:
 
 =back
 
-=head2 Encode::JP::2022_JP -- internally used by Encode::JP
-
-=head2 Encode::JP::2022_JP1 -- internally used by Encode::JP
-
 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
 
-=head2 Encode::JP::JIS -- internally used by Encode::JP
+=head2 Encode::JP::JIS7 -- internally used by Encode::JP
 
 =head2 Encode::Supported -- Supported encodings by Encode
 
@@ -11188,6 +11200,8 @@ reference, e.g.:
 
 =item Built-in Encodings
 
+=item Encode::Unicode -- other Unicode encodings
+
 =item Encode::Byte -- Extended ASCII
 
 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
@@ -11196,7 +11210,7 @@ Cyrillic world
 =item The CJK: Chinese, Japanese, Korean (Multibyte)
 
 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
-Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN
+Encode::HanExtra -- More Chinese via CPAN
 
 =item Miscellaneous encodings
 
@@ -11226,7 +11240,8 @@ KS_C_5601-1987, GB2312, Big5, Shift_JIS
 =item Glossary
 
 character repertoire, coded character set (CCS), character encoding scheme
-(CES), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, UTF-16
+(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
+UTF-16
 
 =item See Also
 
@@ -11239,7 +11254,11 @@ RFC, UC, Unicode Glossary
 
 =item Other Notable Sites
 
-czyborra.com, CJK.inf
+czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ
+
+=item Offline sources
+
+C<CJKV Information Processing> by Ken Lunde
 
 =back
 
@@ -11275,14 +11294,37 @@ czyborra.com, CJK.inf
 
 =back
 
-=head2 Encode::Unicode -- for internal use only
+=head2 Encode::Unicode -- Various Unicode Transform Format
 
-=head2 Encode::XS -- for internal use only
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+L<http://www.unicode.org/glossary/> says:, Quick Reference
+
+=item Size, Endianness, and BOM
+
+=over 4
 
-=head2 Encode::lib::Encode::10646_1, Encode::10656_1 -- for internal use
-only
+=item by Size
 
-=head2 Encode::lib::Encode::Alias, Encode::Alias - alias defintions to
+=item by Endianness
+
+BOM as integer when fetched in network byte order
+
+=back
+
+=item Surrogate Pairs
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::XS -- for internal use only
+
+=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
 encodings
 
 =over 4
@@ -11330,22 +11372,15 @@ Implementation Base Class
 
 =item SEE ALSO
 
-=back
-
-=head2 Encode::lib::Encode::Internal, Encode::Internal -- for internal use
-only
-
-=head2 Encode::lib::Encode::JP::2022_JP, Encode::JP::2022_JP -- internally
-used by Encode::JP
+Scheme 1, Scheme 2, Other Schemes
 
-=head2 Encode::lib::Encode::JP::2022_JP1, Encode::JP::2022_JP1 --
-internally used by Encode::JP
+=back
 
 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
 Encode::JP::2022_JP*
 
-=head2 Encode::lib::Encode::JP::JIS, Encode::JP::JIS -- internally used by
-Encode::JP
+=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
+by Encode::JP
 
 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Supported
 encodings by Encode
@@ -11366,6 +11401,8 @@ encodings by Encode
 
 =item Built-in Encodings
 
+=item Encode::Unicode -- other Unicode encodings
+
 =item Encode::Byte -- Extended ASCII
 
 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
@@ -11374,7 +11411,7 @@ Cyrillic world
 =item The CJK: Chinese, Japanese, Korean (Multibyte)
 
 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
-Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN
+Encode::HanExtra -- More Chinese via CPAN
 
 =item Miscellaneous encodings
 
@@ -11404,7 +11441,8 @@ KS_C_5601-1987, GB2312, Big5, Shift_JIS
 =item Glossary
 
 character repertoire, coded character set (CCS), character encoding scheme
-(CES), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, UTF-16
+(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
+UTF-16
 
 =item See Also
 
@@ -11417,25 +11455,89 @@ RFC, UC, Unicode Glossary
 
 =item Other Notable Sites
 
-czyborra.com, CJK.inf
+czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ
+
+=item Offline sources
+
+C<CJKV Information Processing> by Ken Lunde
 
 =back
 
 =back
 
-=head2 Encode::lib::Encode::Unicode, Encode::Unicode -- for internal use
-only
+=head2 Encode::lib::Encode::Unicode, Encode::Unicode -- Various Unicode
+Transform Format
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+L<http://www.unicode.org/glossary/> says:, Quick Reference
+
+=item Size, Endianness, and BOM
+
+=over 4
+
+=item by Size
+
+=item by Endianness
+
+BOM as integer when fetched in network byte order
+
+=back
+
+=item Surrogate Pairs
+
+=item SEE ALSO
+
+=back
 
 =head2 Encode::lib::Encode::XS, Encode::XS -- for internal use only
 
-=head2 Encode::lib::Encode::ucs2_le, Encode::ucs2_le -- for internal use
-only
+=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
+
+=over 4
+
+=item SYNOPSIS
+
+  use Encode::Encoder;
+  # Encode::encode("ISO-8859-1", $data); 
+  Encode::Encoder->new($data)->iso_8859_1; # OOP way
+  # shortcut
+  use Encode::Encoder qw(encoder);
+  encoder($data)->iso_8859_1;
+  # you can stack them!
+  encoder($data)->iso_8859_1->base64;  # provided base64() is defined
+  # you can use it as a decoder as well
+  encoder($base64)->bytes('base64')->latin1;
+  # stringified
+  print encoder($data)->utf8->latin1;  # prints the string in latin1
+  # numified
+  encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
 
-=head2 Encode::lib::Encode::utf8, Encode::utf8 -- for internal use only
+=item ABSTRACT
+
+=item Description
+
+=over 4
 
-=head2 Encode::ucs2_le -- for internal use only
+=item Predefined Methods
 
-=head2 Encode::utf8 -- for internal use only
+$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
+$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
+$e-E<gt>bytes([$encoding])
+
+=item Example: base64 transcoder
+
+=item operator overloading
+
+=back
+
+=item SEE ALSO
+
+=back
 
 =head2 Encodencoding, encoding -  allows you to write your script in
 non-asii or non-utf8
@@ -11448,7 +11550,7 @@ non-asii or non-utf8
 
 =item USAGE
 
-use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =>
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
 I<ENCNAME_IN> ...] ;, no encoding;
 
 =item CAVEATS
@@ -11461,6 +11563,10 @@ I<ENCNAME_IN> ...] ;, no encoding;
 
 =back
 
+=item NON-ASCII Identifiers and Filter option
+
+use encoding I<ENCNAME> Filter=E<gt>1;
+
 =item EXAMPLE - Greekperl
 
 =item KNOWN PROBLEMS
@@ -11469,6 +11575,49 @@ I<ENCNAME_IN> ...] ;, no encoding;
 
 =back
 
+=head2 Encoder, Encode::Encoder -- Object Oriented Encoder
+
+=over 4
+
+=item SYNOPSIS
+
+  use Encode::Encoder;
+  # Encode::encode("ISO-8859-1", $data); 
+  Encode::Encoder->new($data)->iso_8859_1; # OOP way
+  # shortcut
+  use Encode::Encoder qw(encoder);
+  encoder($data)->iso_8859_1;
+  # you can stack them!
+  encoder($data)->iso_8859_1->base64;  # provided base64() is defined
+  # you can use it as a decoder as well
+  encoder($base64)->bytes('base64')->latin1;
+  # stringified
+  print encoder($data)->utf8->latin1;  # prints the string in latin1
+  # numified
+  encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
+
+=item ABSTRACT
+
+=item Description
+
+=over 4
+
+=item Predefined Methods
+
+$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
+$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
+$e-E<gt>bytes([$encoding])
+
+=item Example: base64 transcoder
+
+=item operator overloading
+
+=back
+
+=item SEE ALSO
+
+=back
+
 =head2 English - use nice English (or awk) names for ugly punctuation
 variables
 
@@ -12312,15 +12461,18 @@ CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
 FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
 INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
-INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN, INST_LIB,
-INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS,
-LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB,
-NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL,
-PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN,
-PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
+INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
+INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
+INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
+INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A,
+LIBS, LINKTYPE, MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET,
+MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
+PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
+PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
-PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SKIP, TYPEMAPS,
-VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
+PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SKIP,
+TYPEMAPS, VENDORPREFIX, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
+XS_VERSION
 
 =item Additional lowercase attributes
 
@@ -12499,6 +12651,10 @@ C<basename>, C<dirname>
 
 =item DESCRIPTION
 
+=item AUTHOR
+
+=item HISTORY
+
 =back
 
 =head2 File::Compare - Compare files or filehandles
@@ -13022,6 +13178,10 @@ TopSystemUID
 
 =item DESCRIPTION
 
+cacheout EXPR, cacheout MODE, EXPR
+
+=item CAVEATS
+
 =item BUGS
 
 =back