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 Github. The project name is "libcodesets" and the
project's page can be found at:

https://github.com/jens-maus/libcodesets

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 codesets.library Open Source Team...

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/
-rw-r--r--  1008/1011     8747   24351  35.9% -lh5- 64a8 Feb 14  2017 codesets/COPYING
-rwxr-xr-x  1008/1011      444     861  51.6% -lh5- ee02 Feb 14  2017 codesets/COPYING.info
-rw-r--r--  1008/1011    13855   43442  31.9% -lh5- aef5 Jan 15 23:17 codesets/ChangeLog
-rwxr-xr-x  1008/1011      443     861  51.5% -lh5- df10 Feb 14  2017 codesets/ChangeLog.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Charsets/
-rw-r--r--  1008/1011     2949   10010  29.5% -lh5- 9a51 Feb 14  2017 codesets/Charsets/ibm866.txt
-rw-r--r--  1008/1011     1875    7079  26.5% -lh5- 4825 Feb 14  2017 codesets/Charsets/iso8859-10.txt
-rw-r--r--  1008/1011     1902    6402  29.7% -lh5- 6ec8 Feb 14  2017 codesets/Charsets/iso8859-7.txt
-rw-r--r--  1008/1011     2848   10671  26.7% -lh5- 6fc2 Feb 14  2017 codesets/Charsets/windows-1250.txt
-rw-r--r--  1008/1011     2822    9311  30.3% -lh5- 36db Feb 14  2017 codesets/Charsets/windows-1251.txt
-rw-r--r--  1008/1011     2904   10490  27.7% -lh5- f158 Feb 14  2017 codesets/Charsets/windows-1252.txt
-rw-r--r--  1008/1011     2777    9041  30.7% -lh5- ff9f Feb 14  2017 codesets/Charsets/windows-1253.txt
-rw-r--r--  1008/1011     2886    9456  30.5% -lh5- 286f Feb 14  2017 codesets/Charsets/windows-1254.txt
-rw-r--r--  1008/1011     2851    8413  33.9% -lh5- 51fc Feb 14  2017 codesets/Charsets/windows-1255.txt
-rw-r--r--  1008/1011     2970    8766  33.9% -lh5- ab58 Feb 14  2017 codesets/Charsets/windows-1256.txt
-rw-r--r--  1008/1011     2811    9327  30.1% -lh5- d1dd Feb 14  2017 codesets/Charsets/windows-1257.txt
-rw-r--r--  1008/1011     2888    9321  31.0% -lh5- 56d7 Feb 14  2017 codesets/Charsets/windows-1258.txt
-rwxr-xr-x  1008/1011     1300    1646  79.0% -lh5- bfbc Feb 14  2017 codesets/Charsets.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/AROS-i386/
-rwxr-xr-x  1008/1011     4463    9980  44.7% -lh5- f0d4 Jan 15 23:17 codesets/Demos/AROS-i386/Convert
-rw-r--r--  1008/1011     4270    9744  43.8% -lh5- db64 Jan 15 23:17 codesets/Demos/AROS-i386/DetectCodeset
-rwxr-xr-x  1008/1011     4202    9372  44.8% -lh5- f451 Jan 15 23:17 codesets/Demos/AROS-i386/UTF8ToStrHook
-rwxr-xr-x  1008/1011     3948    8824  44.7% -lh5- e622 Jan 15 23:17 codesets/Demos/AROS-i386/b64d
-rwxr-xr-x  1008/1011     3947    8824  44.7% -lh5- 9758 Jan 15 23:17 codesets/Demos/AROS-i386/b64e
-rwxr-xr-x  1008/1011     8647   19968  43.3% -lh5- f915 Jan 15 23:17 codesets/Demos/AROS-i386/demo1
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/AROS-ppc/
-rwxr-xr-x  1008/1011     5685   13572  41.9% -lh5- 98be Jan 15 23:17 codesets/Demos/AROS-ppc/Convert
-rw-r--r--  1008/1011     5554   13188  42.1% -lh5- cd99 Jan 15 23:17 codesets/Demos/AROS-ppc/DetectCodeset
-rwxr-xr-x  1008/1011     5337   12800  41.7% -lh5- d92b Jan 15 23:17 codesets/Demos/AROS-ppc/UTF8ToStrHook
-rwxr-xr-x  1008/1011     4974   11960  41.6% -lh5- 82c4 Jan 15 23:17 codesets/Demos/AROS-ppc/b64d
-rwxr-xr-x  1008/1011     4974   11960  41.6% -lh5- b4e4 Jan 15 23:17 codesets/Demos/AROS-ppc/b64e
-rwxr-xr-x  1008/1011    13689   31596  43.3% -lh5- c5b1 Jan 15 23:17 codesets/Demos/AROS-ppc/demo1
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/AROS-x86_64/
-rwxr-xr-x  1008/1011     4906   15368  31.9% -lh5- 5589 Jan 15 23:17 codesets/Demos/AROS-x86_64/Convert
-rw-r--r--  1008/1011     4687   14728  31.8% -lh5- 84bd Jan 15 23:17 codesets/Demos/AROS-x86_64/DetectCodeset
-rwxr-xr-x  1008/1011     4616   14232  32.4% -lh5- e46f Jan 15 23:17 codesets/Demos/AROS-x86_64/UTF8ToStrHook
-rwxr-xr-x  1008/1011     4294   13312  32.3% -lh5- 9286 Jan 15 23:17 codesets/Demos/AROS-x86_64/b64d
-rwxr-xr-x  1008/1011     4293   13312  32.2% -lh5- 838b Jan 15 23:17 codesets/Demos/AROS-x86_64/b64e
-rwxr-xr-x  1008/1011    11668   36920  31.6% -lh5- 6bde Jan 15 23:17 codesets/Demos/AROS-x86_64/demo1
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/AmigaOS3/
-rwxr-xr-x  1008/1011    13894   26124  53.2% -lh5- 4f57 Jan 15 23:17 codesets/Demos/AmigaOS3/Convert
-rw-r--r--  1008/1011    12278   23152  53.0% -lh5- 8fa7 Jan 15 23:17 codesets/Demos/AmigaOS3/DetectCodeset
-rwxr-xr-x  1008/1011    11981   22452  53.4% -lh5- 8f0d Jan 15 23:17 codesets/Demos/AmigaOS3/UTF8ToStrHook
-rwxr-xr-x  1008/1011    11861   22260  53.3% -lh5- 447c Jan 15 23:17 codesets/Demos/AmigaOS3/b64d
-rwxr-xr-x  1008/1011    11861   22260  53.3% -lh5- 145f Jan 15 23:17 codesets/Demos/AmigaOS3/b64e
-rwxr-xr-x  1008/1011    16097   32472  49.6% -lh5- f895 Jan 15 23:17 codesets/Demos/AmigaOS3/demo1
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/AmigaOS4/
-rwxr-xr-x  1008/1011     2398    7388  32.5% -lh5- 685c Jan 15 23:17 codesets/Demos/AmigaOS4/Convert
-rwxr-xr-x  1008/1011     2225    7324  30.4% -lh5- 69d2 Jan 15 23:17 codesets/Demos/AmigaOS4/DetectCodeset
-rwxr-xr-x  1008/1011     1976    6876  28.7% -lh5- a5d3 Jan 15 23:17 codesets/Demos/AmigaOS4/UTF8ToStrHook
-rwxr-xr-x  1008/1011     1701    6536  26.0% -lh5- 65b8 Jan 15 23:17 codesets/Demos/AmigaOS4/b64d
-rwxr-xr-x  1008/1011     1701    6536  26.0% -lh5- 803c Jan 15 23:17 codesets/Demos/AmigaOS4/b64e
-rwxr-xr-x  1008/1011     8912   20184  44.2% -lh5- b21c Jan 15 23:17 codesets/Demos/AmigaOS4/demo1
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Demos/MorphOS/
-rwxr-xr-x  1008/1011    18563   42760  43.4% -lh5- d4ea Jan 15 23:17 codesets/Demos/MorphOS/Convert
-rwxr-xr-x  1008/1011    17673   41072  43.0% -lh5- d8b7 Jan 15 23:17 codesets/Demos/MorphOS/DetectCodeset
-rwxr-xr-x  1008/1011    17642   41028  43.0% -lh5- fcbc Jan 15 23:17 codesets/Demos/MorphOS/UTF8ToStrHook
-rwxr-xr-x  1008/1011    17311   40220  43.0% -lh5- c362 Jan 15 23:17 codesets/Demos/MorphOS/b64d
-rwxr-xr-x  1008/1011    17311   40220  43.0% -lh5- d424 Jan 15 23:17 codesets/Demos/MorphOS/b64e
-rwxr-xr-x  1008/1011    24590   54720  44.9% -lh5- f875 Jan 15 23:17 codesets/Demos/MorphOS/demo1
-rwxr-xr-x  1008/1011     1296    1646  78.7% -lh5- b357 Feb 14  2017 codesets/Demos.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/Autodocs/
-rwxr-xr-x  1008/1011    12085   54183  22.3% -lh5- 3349 Feb 14  2017 codesets/Developer/Autodocs/codesets.doc
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/Examples/
-rw-r--r--  1008/1011     1480    3730  39.7% -lh5- b66e Jan 15 23:17 codesets/Developer/Examples/Convert.c
-rwxr-xr-x  1008/1011     1335    3876  34.4% -lh5- 9e96 Jan 15 23:17 codesets/Developer/Examples/DetectCodeset.c
-rwxr-xr-x  1008/1011     2952    9573  30.8% -lh5- 8bdc Jan 15 23:17 codesets/Developer/Examples/Makefile
-rwxr-xr-x  1008/1011     1330    3019  44.1% -lh5- 763b Jan 15 23:17 codesets/Developer/Examples/UTF8ToStrHook.c
-rw-r--r--  1008/1011      221     410  53.9% -lh5- 164c Feb 14  2017 codesets/Developer/Examples/autoopen.c
-rwxr-xr-x  1008/1011     1068    2464  43.3% -lh5- 373d Jan 15 23:17 codesets/Developer/Examples/b64d.c
-rwxr-xr-x  1008/1011     1064    2458  43.3% -lh5- a287 Jan 15 23:17 codesets/Developer/Examples/b64e.c
-rwxr-xr-x  1008/1011     6288   26745  23.5% -lh5- 01b0 Jan 15 23:17 codesets/Developer/Examples/demo1.c
-rwxr-xr-x  1008/1011     1031    2643  39.0% -lh5- e9af Jan 15 23:17 codesets/Developer/Examples/vastubs.c
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/fd/
-rwxr-xr-x  1008/1011      346    1310  26.4% -lh5- 57d3 Feb 14  2017 codesets/Developer/fd/codesets_lib.fd
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/clib/
-rwxr-xr-x  1008/1011     1064    3866  27.5% -lh5- 9345 Jan 15 23:17 codesets/Developer/include/clib/codesets_protos.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Feb 14  2017 codesets/Developer/include/defines/
-rw-r--r--  1008/1011     1319   10578  12.5% -lh5- 988b Feb 14  2017 codesets/Developer/include/defines/codesets.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/inline/
-rwxr-xr-x  1008/1011     1536    8219  18.7% -lh5- 29bd Jan 15 23:17 codesets/Developer/include/inline/codesets.h
-rw-r--r--  1008/1011     1486   12492  11.9% -lh5- a630 Feb 14  2017 codesets/Developer/include/inline/codesets_protos.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Feb 14  2017 codesets/Developer/include/inline4/
-rw-r--r--  1008/1011     1025    7727  13.3% -lh5- 3888 Feb 14  2017 codesets/Developer/include/inline4/codesets.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Feb 14  2017 codesets/Developer/include/interfaces/
-rw-r--r--  1008/1011      821    5109  16.1% -lh5- 1066 Feb 14  2017 codesets/Developer/include/interfaces/codesets.h
-rw-r--r--  1008/1011      446    2098  21.3% -lh5- b0db Feb 14  2017 codesets/Developer/include/interfaces/codesets.i
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/libraries/
-rwxr-xr-x  1008/1011     2330    8081  28.8% -lh5- 96e4 Jan 15 23:17 codesets/Developer/include/libraries/codesets.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/ppcinline/
-rwxr-xr-x  1008/1011     1560    8376  18.6% -lh5- a0b8 Jan 15 23:17 codesets/Developer/include/ppcinline/codesets.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/pragmas/
-rwxr-xr-x  1008/1011     1380    6549  21.1% -lh5- 3686 Jan 15 23:17 codesets/Developer/include/pragmas/codesets_pragmas.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/include/proto/
-rwxr-xr-x  1008/1011      855    2425  35.3% -lh5- e26b Jan 15 23:17 codesets/Developer/include/proto/codesets.h
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/sfd/
-rw-r--r--  1008/1011      683    3425  19.9% -lh5- f2f6 Feb 14  2017 codesets/Developer/sfd/codesets_lib.sfd
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Developer/xml/
-rw-r--r--  1008/1011      922    6999  13.2% -lh5- 6c3a Feb 14  2017 codesets/Developer/xml/codesets.xml
-rwxr-xr-x  1008/1011     1283    1646  77.9% -lh5- 06c9 Feb 14  2017 codesets/Developer.info
-rwxr-xr-x  1008/1011     1351    4564  29.6% -lh5- 7b3b Feb 14  2017 codesets/Install
-rwxr-xr-x  1008/1011     1443    1853  77.9% -lh5- 15fd Feb 14  2017 codesets/Install.info
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/AROS-i386/
-rwxr-xr-x  1008/1011    31119  113744  27.4% -lh5- 767e Jan 15 23:17 codesets/Libs/AROS-i386/codesets.library
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/AROS-ppc/
-rwxr-xr-x  1008/1011    37477  130512  28.7% -lh5- 7580 Jan 15 23:17 codesets/Libs/AROS-ppc/codesets.library
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/AROS-x86_64/
-rwxr-xr-x  1008/1011    36217  153800  23.5% -lh5- c61a Jan 15 23:17 codesets/Libs/AROS-x86_64/codesets.library
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/AmigaOS3/
-rwxr-xr-x  1008/1011    28777  102260  28.1% -lh5- d942 Jan 15 23:17 codesets/Libs/AmigaOS3/codesets.library
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/AmigaOS4/
-rwxr-xr-x  1008/1011    41662  138756  30.0% -lh5- af6e Jan 15 23:17 codesets/Libs/AmigaOS4/codesets.library
drwxr-xr-x  1008/1011        0       0 ****** -lhd- 0000 Jan 15 23:17 codesets/Libs/MorphOS/
-rwxr-xr-x  1008/1011    42178  138480  30.5% -lh5- 037b Jan 15 23:17 codesets/Libs/MorphOS/codesets.library
-rwxr-xr-x  1008/1011     1297    1646  78.8% -lh5- 9d83 Feb 14  2017 codesets/Libs.info
-rwxr-xr-x  1008/1011     2262    5082  44.5% -lh5- 9ddd Jan 15 23:17 codesets/ReadMe
-rwxr-xr-x  1008/1011      444     861  51.6% -lh5- 37c1 Feb 14  2017 codesets/ReadMe.info
-rwxr-xr-x  1008/1011     1358    1904  71.3% -lh5- 4d4b Feb 14  2017 codesets.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total       123 files  644192 1905801  33.8%            Jan 17 21:55