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  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/
-rw-r--r--  1026/100      8747   24351  35.9% -lh5- 64a8 Aug  4  2016 codesets/COPYING
-rwxr-xr-x  1026/100       444     861  51.6% -lh5- ee02 Aug  4  2016 codesets/COPYING.info
-rw-r--r--  1026/100     13983   43858  31.9% -lh5- 23f3 Feb 26 07:51 codesets/ChangeLog
-rwxr-xr-x  1026/100       443     861  51.5% -lh5- df10 Aug  4  2016 codesets/ChangeLog.info
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Charsets/
-rw-r--r--  1026/100      2949   10010  29.5% -lh5- 9a51 Aug  4  2016 codesets/Charsets/ibm866.txt
-rw-r--r--  1026/100      1875    7079  26.5% -lh5- 4825 Aug  4  2016 codesets/Charsets/iso8859-10.txt
-rw-r--r--  1026/100      1902    6402  29.7% -lh5- 6ec8 Aug  4  2016 codesets/Charsets/iso8859-7.txt
-rw-r--r--  1026/100      2848   10671  26.7% -lh5- 6fc2 Aug  4  2016 codesets/Charsets/windows-1250.txt
-rw-r--r--  1026/100      2822    9311  30.3% -lh5- 36db Aug  4  2016 codesets/Charsets/windows-1251.txt
-rw-r--r--  1026/100      2904   10490  27.7% -lh5- f158 Aug  4  2016 codesets/Charsets/windows-1252.txt
-rw-r--r--  1026/100      2777    9041  30.7% -lh5- ff9f Aug  4  2016 codesets/Charsets/windows-1253.txt
-rw-r--r--  1026/100      2886    9456  30.5% -lh5- 286f Aug  4  2016 codesets/Charsets/windows-1254.txt
-rw-r--r--  1026/100      2851    8413  33.9% -lh5- 51fc Aug  4  2016 codesets/Charsets/windows-1255.txt
-rw-r--r--  1026/100      2970    8766  33.9% -lh5- ab58 Aug  4  2016 codesets/Charsets/windows-1256.txt
-rw-r--r--  1026/100      2811    9327  30.1% -lh5- d1dd Aug  4  2016 codesets/Charsets/windows-1257.txt
-rw-r--r--  1026/100      2888    9321  31.0% -lh5- 56d7 Aug  4  2016 codesets/Charsets/windows-1258.txt
-rwxr-xr-x  1026/100      1300    1646  79.0% -lh5- bfbc Aug  4  2016 codesets/Charsets.info
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/AROS-i386/
-rwxr-xr-x  1026/100      4463    9980  44.7% -lh5- f0d4 Feb 26 07:57 codesets/Demos/AROS-i386/Convert
-rw-r--r--  1026/100      4270    9744  43.8% -lh5- db64 Feb 26 07:57 codesets/Demos/AROS-i386/DetectCodeset
-rwxr-xr-x  1026/100      4202    9372  44.8% -lh5- f451 Feb 26 07:57 codesets/Demos/AROS-i386/UTF8ToStrHook
-rwxr-xr-x  1026/100      3948    8824  44.7% -lh5- e622 Feb 26 07:57 codesets/Demos/AROS-i386/b64d
-rwxr-xr-x  1026/100      3947    8824  44.7% -lh5- 9758 Feb 26 07:57 codesets/Demos/AROS-i386/b64e
-rwxr-xr-x  1026/100      8647   19968  43.3% -lh5- f915 Feb 26 07:57 codesets/Demos/AROS-i386/demo1
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/AROS-ppc/
-rwxr-xr-x  1026/100      5685   13572  41.9% -lh5- 98be Feb 26 07:57 codesets/Demos/AROS-ppc/Convert
-rw-r--r--  1026/100      5554   13188  42.1% -lh5- cd99 Feb 26 07:57 codesets/Demos/AROS-ppc/DetectCodeset
-rwxr-xr-x  1026/100      5337   12800  41.7% -lh5- d92b Feb 26 07:57 codesets/Demos/AROS-ppc/UTF8ToStrHook
-rwxr-xr-x  1026/100      4974   11960  41.6% -lh5- 82c4 Feb 26 07:57 codesets/Demos/AROS-ppc/b64d
-rwxr-xr-x  1026/100      4974   11960  41.6% -lh5- b4e4 Feb 26 07:57 codesets/Demos/AROS-ppc/b64e
-rwxr-xr-x  1026/100     13689   31596  43.3% -lh5- c5b1 Feb 26 07:57 codesets/Demos/AROS-ppc/demo1
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/AROS-x86_64/
-rwxr-xr-x  1026/100      4906   15368  31.9% -lh5- 5589 Feb 26 07:57 codesets/Demos/AROS-x86_64/Convert
-rw-r--r--  1026/100      4687   14728  31.8% -lh5- 84bd Feb 26 07:57 codesets/Demos/AROS-x86_64/DetectCodeset
-rwxr-xr-x  1026/100      4616   14232  32.4% -lh5- e46f Feb 26 07:57 codesets/Demos/AROS-x86_64/UTF8ToStrHook
-rwxr-xr-x  1026/100      4294   13312  32.3% -lh5- 9286 Feb 26 07:57 codesets/Demos/AROS-x86_64/b64d
-rwxr-xr-x  1026/100      4293   13312  32.2% -lh5- 838b Feb 26 07:57 codesets/Demos/AROS-x86_64/b64e
-rwxr-xr-x  1026/100     11668   36920  31.6% -lh5- 6bde Feb 26 07:57 codesets/Demos/AROS-x86_64/demo1
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/AmigaOS3/
-rwxr-xr-x  1026/100     13894   26124  53.2% -lh5- 4f57 Feb 26 07:57 codesets/Demos/AmigaOS3/Convert
-rw-r--r--  1026/100     12278   23152  53.0% -lh5- 8fa7 Feb 26 07:57 codesets/Demos/AmigaOS3/DetectCodeset
-rwxr-xr-x  1026/100     11981   22452  53.4% -lh5- 8f0d Feb 26 07:57 codesets/Demos/AmigaOS3/UTF8ToStrHook
-rwxr-xr-x  1026/100     11861   22260  53.3% -lh5- 447c Feb 26 07:57 codesets/Demos/AmigaOS3/b64d
-rwxr-xr-x  1026/100     11861   22260  53.3% -lh5- 145f Feb 26 07:57 codesets/Demos/AmigaOS3/b64e
-rwxr-xr-x  1026/100     16097   32472  49.6% -lh5- f895 Feb 26 07:57 codesets/Demos/AmigaOS3/demo1
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/AmigaOS4/
-rwxr-xr-x  1026/100      2398    7388  32.5% -lh5- 685c Feb 26 07:57 codesets/Demos/AmigaOS4/Convert
-rwxr-xr-x  1026/100      2225    7324  30.4% -lh5- 69d2 Feb 26 07:57 codesets/Demos/AmigaOS4/DetectCodeset
-rwxr-xr-x  1026/100      1976    6876  28.7% -lh5- a5d3 Feb 26 07:57 codesets/Demos/AmigaOS4/UTF8ToStrHook
-rwxr-xr-x  1026/100      1701    6536  26.0% -lh5- 65b8 Feb 26 07:57 codesets/Demos/AmigaOS4/b64d
-rwxr-xr-x  1026/100      1701    6536  26.0% -lh5- 803c Feb 26 07:57 codesets/Demos/AmigaOS4/b64e
-rwxr-xr-x  1026/100      8912   20184  44.2% -lh5- b21c Feb 26 07:57 codesets/Demos/AmigaOS4/demo1
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Demos/MorphOS/
-rwxr-xr-x  1026/100     18563   42760  43.4% -lh5- d4ea Feb 26 07:57 codesets/Demos/MorphOS/Convert
-rwxr-xr-x  1026/100     17673   41072  43.0% -lh5- d8b7 Feb 26 07:57 codesets/Demos/MorphOS/DetectCodeset
-rwxr-xr-x  1026/100     17642   41028  43.0% -lh5- fcbc Feb 26 07:57 codesets/Demos/MorphOS/UTF8ToStrHook
-rwxr-xr-x  1026/100     17311   40220  43.0% -lh5- c362 Feb 26 07:57 codesets/Demos/MorphOS/b64d
-rwxr-xr-x  1026/100     17311   40220  43.0% -lh5- d424 Feb 26 07:57 codesets/Demos/MorphOS/b64e
-rwxr-xr-x  1026/100     24590   54720  44.9% -lh5- f875 Feb 26 07:57 codesets/Demos/MorphOS/demo1
-rwxr-xr-x  1026/100      1296    1646  78.7% -lh5- b357 Aug  4  2016 codesets/Demos.info
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/Autodocs/
-rwxr-xr-x  1026/100     12085   54183  22.3% -lh5- 3349 Aug  4  2016 codesets/Developer/Autodocs/codesets.doc
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/Examples/
-rw-r--r--  1026/100      1481    3730  39.7% -lh5- eb4d May 13  2021 codesets/Developer/Examples/Convert.c
-rwxr-xr-x  1026/100      1334    3876  34.4% -lh5- 7f6f May 13  2021 codesets/Developer/Examples/DetectCodeset.c
-rwxr-xr-x  1026/100      2952    9573  30.8% -lh5- 6481 May 13  2021 codesets/Developer/Examples/Makefile
-rwxr-xr-x  1026/100      1328    3019  44.0% -lh5- 31e0 May 13  2021 codesets/Developer/Examples/UTF8ToStrHook.c
-rw-r--r--  1026/100       221     410  53.9% -lh5- 164c Aug  4  2016 codesets/Developer/Examples/autoopen.c
-rwxr-xr-x  1026/100      1067    2464  43.3% -lh5- d6b9 May 13  2021 codesets/Developer/Examples/b64d.c
-rwxr-xr-x  1026/100      1064    2458  43.3% -lh5- 5b22 May 13  2021 codesets/Developer/Examples/b64e.c
-rwxr-xr-x  1026/100      6289   26745  23.5% -lh5- 7860 May 13  2021 codesets/Developer/Examples/demo1.c
-rwxr-xr-x  1026/100      1031    2643  39.0% -lh5- cde1 May 13  2021 codesets/Developer/Examples/vastubs.c
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/fd/
-rwxr-xr-x  1026/100       346    1310  26.4% -lh5- 57d3 Aug  4  2016 codesets/Developer/fd/codesets_lib.fd
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/include/
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/clib/
-rwxr-xr-x  1026/100      1064    3866  27.5% -lh5- b003 May 13  2021 codesets/Developer/include/clib/codesets_protos.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Aug  4  2016 codesets/Developer/include/defines/
-rw-r--r--  1026/100      1319   10578  12.5% -lh5- 988b Aug  4  2016 codesets/Developer/include/defines/codesets.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/inline/
-rwxr-xr-x  1026/100      1536    8219  18.7% -lh5- aa32 May 13  2021 codesets/Developer/include/inline/codesets.h
-rw-r--r--  1026/100      1486   12492  11.9% -lh5- a630 Aug  4  2016 codesets/Developer/include/inline/codesets_protos.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Aug  4  2016 codesets/Developer/include/inline4/
-rw-r--r--  1026/100      1025    7727  13.3% -lh5- 3888 Aug  4  2016 codesets/Developer/include/inline4/codesets.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Aug  4  2016 codesets/Developer/include/interfaces/
-rw-r--r--  1026/100       821    5109  16.1% -lh5- 1066 Aug  4  2016 codesets/Developer/include/interfaces/codesets.h
-rw-r--r--  1026/100       446    2098  21.3% -lh5- b0db Aug  4  2016 codesets/Developer/include/interfaces/codesets.i
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/libraries/
-rwxr-xr-x  1026/100      2330    8081  28.8% -lh5- f245 May 13  2021 codesets/Developer/include/libraries/codesets.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/ppcinline/
-rwxr-xr-x  1026/100      1561    8376  18.6% -lh5- 7e87 May 13  2021 codesets/Developer/include/ppcinline/codesets.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/pragmas/
-rwxr-xr-x  1026/100      1380    6549  21.1% -lh5- 983f May 13  2021 codesets/Developer/include/pragmas/codesets_pragmas.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 May 13  2021 codesets/Developer/include/proto/
-rwxr-xr-x  1026/100       854    2425  35.2% -lh5- 563d May 13  2021 codesets/Developer/include/proto/codesets.h
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/sfd/
-rw-r--r--  1026/100       683    3425  19.9% -lh5- f2f6 Aug  4  2016 codesets/Developer/sfd/codesets_lib.sfd
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Developer/xml/
-rw-r--r--  1026/100       922    6999  13.2% -lh5- 6c3a Aug  4  2016 codesets/Developer/xml/codesets.xml
-rwxr-xr-x  1026/100      1283    1646  77.9% -lh5- 06c9 Aug  4  2016 codesets/Developer.info
-rwxr-xr-x  1026/100      1530    5277  29.0% -lh5- 33c8 May 13  2021 codesets/Install
-rwxr-xr-x  1026/100      1443    1853  77.9% -lh5- 15fd Aug  4  2016 codesets/Install.info
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/AROS-i386/
-rwxr-xr-x  1026/100     31182  113896  27.4% -lh5- a0c2 Feb 26 07:57 codesets/Libs/AROS-i386/codesets.library
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/AROS-ppc/
-rwxr-xr-x  1026/100     37555  130692  28.7% -lh5- da42 Feb 26 07:57 codesets/Libs/AROS-ppc/codesets.library
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/AROS-x86_64/
-rwxr-xr-x  1026/100     36221  153880  23.5% -lh5- 3702 Feb 26 07:57 codesets/Libs/AROS-x86_64/codesets.library
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/AmigaOS3/
-rwxr-xr-x  1026/100     28816  102320  28.2% -lh5- 58b6 Feb 26 07:57 codesets/Libs/AmigaOS3/codesets.library
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/AmigaOS4/
-rwxr-xr-x  1026/100     41732  138792  30.1% -lh5- ba46 Feb 26 07:57 codesets/Libs/AmigaOS4/codesets.library
drwxr-xr-x  1026/100         0       0 ****** -lhd- 0000 Feb 26 07:57 codesets/Libs/MorphOS/
-rwxr-xr-x  1026/100     42240  138640  30.5% -lh5- 6ceb Feb 26 07:57 codesets/Libs/MorphOS/codesets.library
-rwxr-xr-x  1026/100      1297    1646  78.8% -lh5- 9d83 Aug  4  2016 codesets/Libs.info
-rwxr-xr-x  1026/100      2262    5082  44.5% -lh5- e6a4 Feb 26 07:56 codesets/ReadMe
-rwxr-xr-x  1026/100       444     861  51.6% -lh5- 37c1 Aug  4  2016 codesets/ReadMe.info
-rwxr-xr-x  1026/100      1358    1904  71.3% -lh5- 4d4b Aug  4  2016 codesets.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total       123 files  644813 1907598  33.8%            Feb 28 16:08