Introduction
~~~~~~~~~~~~
Classic Amiga systems, but even modern AmigaOS versions like AmigaOS4 and
MorphOS don't come with a centralized programming interface for dealing
with different codesets. Especially for the more and more important dealing
with the UTF-8 codeset (e.g. in internet communication programs like YAM or
SimpleMail) a centralized way or API is definitly required and provides
signification advantages. In addition, it should serve as a single interface
point for developers wanting to develop multi-platform applications without
having to implement charset conversion routines on each OS differently.

codesets.library should solve this by providing 3rd party developers an
efficient and easy to use API for dealing with different codesets like
ISO-8859-15, Amiga-1251 but also the mentioned UTF-8 standard, etc. It is
already widly used in known programs like YAM (Internet Mailer) for
example and therefore considered very stable.

The currently internally supported (hardcoded) charsets/codesets are:
(conversions are possible from and to each codeset)

AmigaPL           - Polish (Amiga)
Amiga-1251        - Cyrillic (Amiga)
ISO-8859-1        - West European
ISO-8859-1 + Euro - West European (with EURO)
ISO-8859-2        - Central/East European
ISO-8859-3        - South European
ISO-8859-4        - North European
ISO-8859-5        - Slavic languages
ISO-8859-9        - Turkish
ISO-8859-15       - West European II
ISO-8859-16       - South-Eastern European
KOI8-R            - Russian
UTF-8             - Unicode

In addition, external charset table files can be stored in LIBS:Charsets
or loaded by an application from PROGDIR:Charsets. The charset files included
with this distributions are:

IBM866        - Cyrillic (cp866)
ISO-8859-7    - Greek (LatinGreek)
ISO-8859-10   - Nordic (Latin 6)
windows-1250  - Central/East Europe (Windows)
windows-1251  - Cyrillic (Windows)
windows-1252  - West European (Windows)

More additional, but rarly used charset tables can be found at:
http://www.unicode.org/Public/MAPPINGS/

NOTE: Please note that on operating systems having own codeset/charset
querying support (e.g. AmigaOS4), codesets.library tries to use the system's
functionality as much as possible and will load all additional codesets
supported by the OS itself. Therefore, the above list is just meant to list
the very bare minimum of supported codesets. Please check with your
operating system manual before manually installing additional charset
tables as they might already be available in your OS. In case an internal
charset conflicts with an external charset file, the internal charset is
preferred.

The library is available for AmigaOS3 (m68k), AmigaOS4 (PPC), MorphOS (PPC)
or for AROS.

It is an open-source development effort of many people and is
kindly hosted on SourceForge. The project name is "codesetslib" and the
project's page can be found at:

http://www.sf.net/projects/codesetslib/

Please use this address for further updates, bug reports and feature
requests and try to avoid direct mail contact to single developers. We really
prefer to get bug reports via the sourceforge.net platform if possible.

Installation
~~~~~~~~~~~~
1) Extract the archive to a temporary directory.

   > cd RAM:
   > lha x codesets.lha

2) Go to the "codesetsLibrary/Libs/<OS>" directory where <OS> is the directory
   matching the operating system you want to install the library for.

   > cd codesets/Libs/AmigaOS4

3) copy the library out of the <OS> directory to your LIBS: directory.

   > copy codesets.library LIBS:

4) In case you are running an operating system from which codesets.library
   can't directly obtain additional charsets/codesets, you have to copy
   additional charset files to the LIBS:Charsets directory. (This is only
   required for AmigaOS3 and MorphOS):

   > cd RAM:codesets
   > copy ALL Charsets LIBS:

5) reboot and enjoy ;)

History
~~~~~~~
Since version 6.0, codesets.library development is publically hosted and
maintained by an open-source developer community. Many major changes have
been made during the first open-source release cycle of 6.0. Therefore,
include files and some internal functions have been changed a lot. If you
were already using version 5.x in your applications you are supposed to
update them according to the new 6.x library interface. However, the library
was tried to be still somehwat compatible to the old 5.x API.

For a detailed change log since the last release please consult the
included "ChangeLog" file in the distribution archive.

         __
        / /
   __  / /   Only Amiga makes it possible...
   \ \/ /
    \__/

Amiga is a trademark of Amiga, Inc.

Your codestes.library Open Source Team...

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/
-rw-r--r--  1000/1000      783    1575  49.7% -lh5- 1825 Oct 24  2009 codesets/AUTHORS
-rwxr-xr-x  1000/1000      444     861  51.6% -lh5- d27d Aug 31  2010 codesets/AUTHORS.info
-rw-r--r--  1000/1000     8747   24351  35.9% -lh5- 64a8 Jan 27  2007 codesets/COPYING
-rwxr-xr-x  1000/1000      444     861  51.6% -lh5- ee02 Aug 31  2010 codesets/COPYING.info
-rw-r--r--  1000/1000    12731   38828  32.8% -lh5- 5a1a Nov 26 07:09 codesets/ChangeLog
-rwxr-xr-x  1000/1000      443     861  51.5% -lh5- df10 Aug 31  2010 codesets/ChangeLog.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Charsets/
-rw-r--r--  1000/1000     2957   10023  29.5% -lh5- 49dc Jan 27  2007 codesets/Charsets/ibm866.txt
-rw-r--r--  1000/1000     1875    7079  26.5% -lh5- 4825 May  1  2010 codesets/Charsets/iso8859-10.txt
-rw-r--r--  1000/1000     1902    6402  29.7% -lh5- 6ec8 May  1  2010 codesets/Charsets/iso8859-7.txt
-rw-r--r--  1000/1000     2848   10671  26.7% -lh5- 6fc2 May  1  2010 codesets/Charsets/windows-1250.txt
-rw-r--r--  1000/1000     2822    9311  30.3% -lh5- 36db May  1  2010 codesets/Charsets/windows-1251.txt
-rw-r--r--  1000/1000     2904   10490  27.7% -lh5- f158 May  1  2010 codesets/Charsets/windows-1252.txt
-rw-r--r--  1000/1000     2777    9041  30.7% -lh5- ff9f May  1  2010 codesets/Charsets/windows-1253.txt
-rwxr-xr-x  1000/1000     1300    1646  79.0% -lh5- bfbc Aug 31  2010 codesets/Charsets.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/AROS-i386/
-rwxr-xr-x  1000/1000     4477   10020  44.7% -lh5- e8e7 Nov 26 07:10 codesets/Demos/AROS-i386/Convert
-rw-r--r--  1000/1000     4272    9784  43.7% -lh5- 241f Nov 26 07:10 codesets/Demos/AROS-i386/DetectCodeset
-rwxr-xr-x  1000/1000     4220    9412  44.8% -lh5- fdd6 Nov 26 07:10 codesets/Demos/AROS-i386/UTF8ToStrHook
-rwxr-xr-x  1000/1000     3955    8832  44.8% -lh5- 0b77 Nov 26 07:10 codesets/Demos/AROS-i386/b64d
-rwxr-xr-x  1000/1000     3954    8832  44.8% -lh5- 6ec7 Nov 26 07:10 codesets/Demos/AROS-i386/b64e
-rwxr-xr-x  1000/1000     8561   19780  43.3% -lh5- ed31 Nov 26 07:10 codesets/Demos/AROS-i386/demo1
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/AROS-ppc/
-rwxr-xr-x  1000/1000     5685   13572  41.9% -lh5- 98be Nov 26 07:10 codesets/Demos/AROS-ppc/Convert
-rw-r--r--  1000/1000     5554   13188  42.1% -lh5- cd99 Nov 26 07:10 codesets/Demos/AROS-ppc/DetectCodeset
-rwxr-xr-x  1000/1000     5337   12800  41.7% -lh5- d92b Nov 26 07:10 codesets/Demos/AROS-ppc/UTF8ToStrHook
-rwxr-xr-x  1000/1000     4974   11960  41.6% -lh5- 82c4 Nov 26 07:10 codesets/Demos/AROS-ppc/b64d
-rwxr-xr-x  1000/1000     4974   11960  41.6% -lh5- b4e4 Nov 26 07:10 codesets/Demos/AROS-ppc/b64e
-rwxr-xr-x  1000/1000    13622   31420  43.4% -lh5- 28ec Nov 26 07:10 codesets/Demos/AROS-ppc/demo1
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/AROS-x86_64/
-rwxr-xr-x  1000/1000     4906   15368  31.9% -lh5- 5589 Nov 26 07:10 codesets/Demos/AROS-x86_64/Convert
-rw-r--r--  1000/1000     4687   14728  31.8% -lh5- 84bd Nov 26 07:10 codesets/Demos/AROS-x86_64/DetectCodeset
-rwxr-xr-x  1000/1000     4616   14232  32.4% -lh5- e46f Nov 26 07:10 codesets/Demos/AROS-x86_64/UTF8ToStrHook
-rwxr-xr-x  1000/1000     4294   13312  32.3% -lh5- 9286 Nov 26 07:10 codesets/Demos/AROS-x86_64/b64d
-rwxr-xr-x  1000/1000     4293   13312  32.2% -lh5- 838b Nov 26 07:10 codesets/Demos/AROS-x86_64/b64e
-rwxr-xr-x  1000/1000    11534   36480  31.6% -lh5- b992 Nov 26 07:10 codesets/Demos/AROS-x86_64/demo1
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/AmigaOS3/
-rwxr-xr-x  1000/1000    14021   27176  51.6% -lh5- 1213 Nov 26 07:10 codesets/Demos/AmigaOS3/Convert
-rw-r--r--  1000/1000    12406   24024  51.6% -lh5- faf5 Nov 26 07:10 codesets/Demos/AmigaOS3/DetectCodeset
-rwxr-xr-x  1000/1000    12070   23328  51.7% -lh5- d6bd Nov 26 07:10 codesets/Demos/AmigaOS3/UTF8ToStrHook
-rwxr-xr-x  1000/1000    11973   23136  51.8% -lh5- 40bc Nov 26 07:10 codesets/Demos/AmigaOS3/b64d
-rwxr-xr-x  1000/1000    11973   23136  51.8% -lh5- 6dfa Nov 26 07:10 codesets/Demos/AmigaOS3/b64e
-rwxr-xr-x  1000/1000    16177   33236  48.7% -lh5- b59d Nov 26 07:10 codesets/Demos/AmigaOS3/demo1
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/AmigaOS4/
-rwxr-xr-x  1000/1000     2374    7268  32.7% -lh5- d702 Nov 26 07:10 codesets/Demos/AmigaOS4/Convert
-rwxr-xr-x  1000/1000     2248    7200  31.2% -lh5- 0c76 Nov 26 07:10 codesets/Demos/AmigaOS4/DetectCodeset
-rwxr-xr-x  1000/1000     1979    6820  29.0% -lh5- 64a6 Nov 26 07:10 codesets/Demos/AmigaOS4/UTF8ToStrHook
-rwxr-xr-x  1000/1000     1690    6412  26.4% -lh5- 955b Nov 26 07:10 codesets/Demos/AmigaOS4/b64d
-rwxr-xr-x  1000/1000     1687    6412  26.3% -lh5- de4a Nov 26 07:10 codesets/Demos/AmigaOS4/b64e
-rwxr-xr-x  1000/1000     8854   20028  44.2% -lh5- baa1 Nov 26 07:10 codesets/Demos/AmigaOS4/demo1
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Demos/MorphOS/
-rwxr-xr-x  1000/1000    16656   38728  43.0% -lh5- e3f8 Nov 26 07:10 codesets/Demos/MorphOS/Convert
-rw-r--r--  1000/1000    16111   37420  43.1% -lh5- 99f1 Nov 26 07:10 codesets/Demos/MorphOS/DetectCodeset
-rwxr-xr-x  1000/1000    15689   36496  43.0% -lh5- 0c66 Nov 26 07:10 codesets/Demos/MorphOS/UTF8ToStrHook
-rwxr-xr-x  1000/1000    15437   35820  43.1% -lh5- 7b24 Nov 26 07:10 codesets/Demos/MorphOS/b64d
-rwxr-xr-x  1000/1000    15436   35820  43.1% -lh5- 72fe Nov 26 07:10 codesets/Demos/MorphOS/b64e
-rwxr-xr-x  1000/1000    21826   51156  42.7% -lh5- cc6d Nov 26 07:10 codesets/Demos/MorphOS/demo1
-rwxr-xr-x  1000/1000     1296    1646  78.7% -lh5- b357 Aug 31  2010 codesets/Demos.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/Autodocs/
-rwxr-xr-x  1000/1000    11644   52038  22.4% -lh5- ad0a Jul 29  2008 codesets/Developer/Autodocs/codesets.doc
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/Examples/
-rw-r--r--  1000/1000     1518    3780  40.2% -lh5- a415 Aug 31  2010 codesets/Developer/Examples/Convert.c
-rwxr-xr-x  1000/1000     1378    3932  35.0% -lh5- 3d4b Aug 31  2010 codesets/Developer/Examples/DetectCodeset.c
-rwxr-xr-x  1000/1000     2972    9601  31.0% -lh5- a4da Aug 31  2010 codesets/Developer/Examples/Makefile
-rwxr-xr-x  1000/1000     1360    3061  44.4% -lh5- e9bc Jun  7  2009 codesets/Developer/Examples/UTF8ToStrHook.c
-rw-r--r--  1000/1000      221     410  53.9% -lh5- 164c Mar 24  2009 codesets/Developer/Examples/autoopen.c
-rwxr-xr-x  1000/1000     1108    2511  44.1% -lh5- 450b Aug 31  2010 codesets/Developer/Examples/b64d.c
-rwxr-xr-x  1000/1000     1101    2505  44.0% -lh5- fc8b Aug 31  2010 codesets/Developer/Examples/b64e.c
-rwxr-xr-x  1000/1000     6317   26727  23.6% -lh5- 8af5 Aug 31  2010 codesets/Developer/Examples/demo1.c
-rwxr-xr-x  1000/1000     1067    2684  39.8% -lh5- bee9 Jul  5  2008 codesets/Developer/Examples/vastubs.c
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/fd/
-rwxr-xr-x  1000/1000      346    1310  26.4% -lh5- 57d3 Jan 27  2007 codesets/Developer/fd/codesets_lib.fd
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/clib/
-rwxr-xr-x  1000/1000     1095    3878  28.2% -lh5- 60f3 Jan 27  2007 codesets/Developer/include/clib/codesets_protos.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/defines/
-rw-r--r--  1000/1000     1311   10550  12.4% -lh5- a923 Apr 16  2009 codesets/Developer/include/defines/codesets.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/inline/
-rwxr-xr-x  1000/1000     1562    8242  19.0% -lh5- 8cd8 Jan 27  2007 codesets/Developer/include/inline/codesets.h
-rw-r--r--  1000/1000     1481   12450  11.9% -lh5- 7a66 Aug 16  2008 codesets/Developer/include/inline/codesets_protos.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/inline4/
-rw-r--r--  1000/1000     1025    7727  13.3% -lh5- 3888 Jan 27  2007 codesets/Developer/include/inline4/codesets.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/interfaces/
-rw-r--r--  1000/1000      817    5068  16.1% -lh5- 9465 Jan 27  2007 codesets/Developer/include/interfaces/codesets.h
-rw-r--r--  1000/1000      446    2098  21.3% -lh5- b0db Jan 27  2007 codesets/Developer/include/interfaces/codesets.i
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/libraries/
-rwxr-xr-x  1000/1000     1957    6339  30.9% -lh5- dc48 Oct 24  2009 codesets/Developer/include/libraries/codesets.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/ppcinline/
-rwxr-xr-x  1000/1000     1586    8399  18.9% -lh5- c9d4 Jan 27  2007 codesets/Developer/include/ppcinline/codesets.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/pragmas/
-rwxr-xr-x  1000/1000     1414    6604  21.4% -lh5- 6eed Jan 27  2007 codesets/Developer/include/pragmas/codesets_pragmas.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/include/proto/
-rwxr-xr-x  1000/1000      890    2478  35.9% -lh5- 532b Mar 21  2009 codesets/Developer/include/proto/codesets.h
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/sfd/
-rw-r--r--  1000/1000      721    3439  21.0% -lh5- 9aa8 Mar 21  2009 codesets/Developer/sfd/codesets_lib.sfd
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Developer/xml/
-rw-r--r--  1000/1000      916    6957  13.2% -lh5- e225 Jan 27  2007 codesets/Developer/xml/codesets.xml
-rwxr-xr-x  1000/1000     1283    1646  77.9% -lh5- 06c9 Aug 31  2010 codesets/Developer.info
-rwxr-xr-x  1000/1000     1269    4246  29.9% -lh5- f576 Mar  3  2011 codesets/Install
-rwxr-xr-x  1000/1000     1443    1853  77.9% -lh5- 15fd Aug 31  2010 codesets/Install.info
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/AROS-i386/
-rwxr-xr-x  1000/1000    32852  116796  28.1% -lh5- fca4 Nov 26 07:10 codesets/Libs/AROS-i386/codesets.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/AROS-ppc/
-rwxr-xr-x  1000/1000    41766  131024  31.9% -lh5- 7433 Nov 26 07:10 codesets/Libs/AROS-ppc/codesets.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/AROS-x86_64/
-rwxr-xr-x  1000/1000    39431  157160  25.1% -lh5- fe11 Nov 26 07:10 codesets/Libs/AROS-x86_64/codesets.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/AmigaOS3/
-rwxr-xr-x  1000/1000    28570  102660  27.8% -lh5- d371 Nov 26 07:10 codesets/Libs/AmigaOS3/codesets.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/AmigaOS4/
-rwxr-xr-x  1000/1000    46456  146604  31.7% -lh5- aedc Nov 26 07:10 codesets/Libs/AmigaOS4/codesets.library
drwxr-xr-x  1000/1000        0       0 ****** -lhd- 0000 Nov 26 07:10 codesets/Libs/MorphOS/
-rwxr-xr-x  1000/1000    40239  141628  28.4% -lh5- 4f94 Nov 26 07:10 codesets/Libs/MorphOS/codesets.library
-rwxr-xr-x  1000/1000     1297    1646  78.8% -lh5- 9d83 Aug 31  2010 codesets/Libs.info
-rwxr-xr-x  1000/1000     2266    5099  44.4% -lh5- 5efa Nov 26 06:59 codesets/ReadMe
-rwxr-xr-x  1000/1000      444     861  51.6% -lh5- 37c1 Aug 31  2010 codesets/ReadMe.info
-rwxr-xr-x  1000/1000     1358    1904  71.3% -lh5- 4d4b Aug 31  2010 codesets.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       120 files  629722 1852169  34.0%            Nov 26 21:42