Comment tweak from Philip.
[p5sagit/p5-mst-13.2.git] / ext / Encode / Byte / Byte.pm
index 5b49dd9..e570505 100644 (file)
@@ -1,12 +1,13 @@
 package Encode::Byte;
 use Encode;
-our $VERSION = do { my @r = (q$Revision: 0.96 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
+our $VERSION = do { my @r = (q$Revision: 1.21 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
 
 use XSLoader;
-XSLoader::load('Encode::Byte',$VERSION);
+XSLoader::load(__PACKAGE__,$VERSION);
 
 1;
 __END__
+
 =head1 NAME
 
 Encode::Byte - Single Byte Encodings
@@ -14,8 +15,8 @@ Encode::Byte - Single Byte Encodings
 =head1 SYNOPSIS
 
     use Encode qw/encode decode/; 
-    $latin1 = encode("iso-8859-1", $utf8);   # loads Encode::Byte implicitly
-    $utf8  = decode("iso-8859-1", $latin1);  # ditto
+    $greek = encode("iso-885-7", $utf8);   # loads Encode::Byte implicitly
+    $utf8  = decode("iso-8859-7", $greek); # ditto
 
 =head1 ABSTRACT
 
@@ -23,54 +24,89 @@ This module implements various single byte encodings.  For most cases it uses
 \x80-\xff (upper half) to map non-ASCII characters.  Encodings
 supported are as follows.   
 
-  Canonical   Alias            Description
+  Canonical      Alias                               Description
   --------------------------------------------------------------------
-  iso-8859-1    latin1
-  iso-8859-2    latin2
-  iso-8859-3    latin3
-  iso-8859-4    latin4
-  iso-8859-5    latin
-  iso-8859-6    latin
-  iso-8859-7
-  iso-8859-8
-  iso-8859-9    latin5
-  iso-8859-10   latin6
+  # ISO 8859 series
+  (iso-8859-1  is in built-in)
+  iso-8859-2   latin2                                       [ISO]
+  iso-8859-3   latin3                                       [ISO]
+  iso-8859-4   latin4                                       [ISO]
+  iso-8859-5                                                [ISO]
+  iso-8859-6                                                [ISO]
+  iso-8859-7                                                [ISO]
+  iso-8859-8                                                [ISO]
+  iso-8859-9   latin5                                       [ISO]
+  iso-8859-10  latin6                                       [ISO]
   iso-8859-11
   (iso-8859-12 is nonexistent)
-  iso-8859-13   latin7
-  iso-8859-14   latin8
-  iso-8859-15   latin9
-  iso-8859-16   latin10
-
-  koi8-f
-  koi8-r
-  koi8-u
-
-  viscii        # ASCII + vietnamese
-
-  cp1250        WinLatin2
-  cp1251        WinCyrillic
-  cp1252        WinLatin1
-  cp1253        WinGreek
-  cp1254        WinTurkiskh
-  cp1255        WinHebrew
-  cp1256        WinArabic
-  cp1257        WinBaltic
-  cp1258        WinVietnamese
-  # all cp* are also available as ibm-* and ms-*
-
-  maccentraleuropean  
-  maccroatian
-  macroman
-  maccyrillic
-  macromanian
-  macdingbats       
-  macsami
-  macgreek 
-  macthai
-  macicelandic    
-  macturkish
-  macukraine
+  iso-8859-13   latin7                                      [ISO]
+  iso-8859-14  latin8                                       [ISO]
+  iso-8859-15  latin9                                       [ISO]
+  iso-8859-16  latin10                                      [ISO]
+
+  # Cyrillic
+  koi8-f                                       
+  koi8-r        cp878                                   [RFC1489]
+  koi8-u                                                [RFC2319]
+
+  # Vietnamese
+  viscii
+  
+  # all cp* are also available as ibm-*, ms-*, and windows-*
+  # also see L<http://msdn.microsoft.com/workshop/author/dhtml/reference/charsets/charset4.asp>
+
+  cp424  
+  cp437  
+  cp737  
+  cp775  
+  cp850  
+  cp852  
+  cp855  
+  cp856  
+  cp857  
+  cp860  
+  cp861  
+  cp862  
+  cp863  
+  cp864  
+  cp865  
+  cp866  
+  cp869  
+  cp874  
+  cp1006  
+  cp1250       WinLatin2
+  cp1251       WinCyrillic
+  cp1252       WinLatin1
+  cp1253       WinGreek
+  cp1254       WinTurkiskh
+  cp1255       WinHebrew
+  cp1256       WinArabic
+  cp1257       WinBaltic
+  cp1258       WinVietnamese
+
+  # Macintosh
+  # Also see L<http://developer.apple.com/technotes/tn/tn1150.html>
+  MacArabic  
+  MacCentralEurRoman  
+  MacCroatian  
+  MacCyrillic  
+  MacFarsi  
+  MacGreek  
+  MacHebrew  
+  MacIcelandic  
+  MacRoman  
+  MacRomanian  
+  MacRumanian  
+  MacSami  
+  MacThai  
+  MacTurkish  
+  MacUkrainian  
+
+  # More vendor encodings
+  AdobeStandardEncoding
+  nextstep
+  gsm0338      # used in GSM handsets
+  hp-roman8
 
 =head1 DESCRIPTION