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) and even
MorphOS (PPC).

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
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1299    1646  78.9% -lh5- bffe Jan 27  2007 codesets.info
[generic]                  707    1448  48.8% -lh5- ffec Jul 29  2007 codesets/AUTHORS
[generic]                  444     861  51.6% -lh5- d27d Jan 27  2007 codesets/AUTHORS.info
[generic]                 7471   21638  34.5% -lh5- 8641 Jul  6 07:11 codesets/ChangeLog
[generic]                  443     861  51.5% -lh5- df10 Jan 27  2007 codesets/ChangeLog.info
[generic]                 1300    1646  79.0% -lh5- bfbc Jan 27  2007 codesets/Charsets.info
[generic]                 2957   10023  29.5% -lh5- 49dc Jan 27  2007 codesets/Charsets/ibm866.txt
[generic]                 1875    7079  26.5% -lh5- 4825 Jan 27  2007 codesets/Charsets/iso8859-10.txt
[generic]                 1902    6402  29.7% -lh5- 6ec8 Jan 27  2007 codesets/Charsets/iso8859-7.txt
[generic]                 2848   10671  26.7% -lh5- 6fc2 Jan 27  2007 codesets/Charsets/windows-1250.txt
[generic]                 2822    9311  30.3% -lh5- 36db Jan 27  2007 codesets/Charsets/windows-1251.txt
[generic]                 2904   10490  27.7% -lh5- f158 Jan 27  2007 codesets/Charsets/windows-1252.txt
[generic]                 8747   24351  35.9% -lh5- 64a8 Jan 27  2007 codesets/COPYING
[generic]                  444     861  51.6% -lh5- ee02 Jan 27  2007 codesets/COPYING.info
[generic]                 1296    1646  78.7% -lh5- b357 Jan 27  2007 codesets/Demos.info
[generic]                13607   26700  51.0% -lh5- 4fd0 Jul  6 07:18 codesets/Demos/AmigaOS3/b64d
[generic]                13607   26700  51.0% -lh5- d96c Jul  6 07:18 codesets/Demos/AmigaOS3/b64e
[generic]                17927   37208  48.2% -lh5- a03b Jul  6 07:18 codesets/Demos/AmigaOS3/demo1
[generic]                14022   27588  50.8% -lh5- 40d8 Jul  6 07:18 codesets/Demos/AmigaOS3/DetectCodeset
[generic]                13705   26888  51.0% -lh5- 32d3 Jul  6 07:18 codesets/Demos/AmigaOS3/UTF8ToStrHook
[generic]                 1631    3352  48.7% -lh5- 18d1 Jul  6 07:18 codesets/Demos/AmigaOS4/b64d
[generic]                 1631    3352  48.7% -lh5- 879c Jul  6 07:18 codesets/Demos/AmigaOS4/b64e
[generic]                 9385   17848  52.6% -lh5- 0667 Jul  6 07:18 codesets/Demos/AmigaOS4/demo1
[generic]                 2223    4560  48.8% -lh5- 13c4 Jul  6 07:18 codesets/Demos/AmigaOS4/DetectCodeset
[generic]                 1901    3916  48.5% -lh5- e006 Jul  6 07:18 codesets/Demos/AmigaOS4/UTF8ToStrHook
[generic]                15124   35380  42.7% -lh5- 2f09 Jul  6 07:18 codesets/Demos/MorphOS/b64d
[generic]                15123   35380  42.7% -lh5- 43fd Jul  6 07:18 codesets/Demos/MorphOS/b64e
[generic]                21597   50980  42.4% -lh5- ed81 Jul  6 07:18 codesets/Demos/MorphOS/demo1
[generic]                15792   36980  42.7% -lh5- 4be3 Jul  6 07:18 codesets/Demos/MorphOS/DetectCodeset
[generic]                15406   36052  42.7% -lh5- 3519 Jul  6 07:18 codesets/Demos/MorphOS/UTF8ToStrHook
[generic]                 1283    1646  77.9% -lh5- 06c9 Jan 27  2007 codesets/Developer.info
[generic]                11640   52038  22.4% -lh5- 2c5b Jul  6 07:11 codesets/Developer/AutoDocs/codesets.doc
[generic]                 1096    2493  44.0% -lh5- c65b Jul  5 16:13 codesets/Developer/Examples/b64d.c
[generic]                 1090    2490  43.8% -lh5- 329e Jan 27  2007 codesets/Developer/Examples/b64e.c
[generic]                 6390   27450  23.3% -lh5- 808f Jul  5 16:13 codesets/Developer/Examples/demo1.c
[generic]                 1379    3870  35.6% -lh5- e1b1 Nov 25  2007 codesets/Developer/Examples/DetectCodeset.c
[generic]                 2702    7767  34.8% -lh5- 70a6 Jul  5 16:07 codesets/Developer/Examples/Makefile
[generic]                 1510    3566  42.3% -lh5- e89e Nov 25  2007 codesets/Developer/Examples/UTF8ToStrHook.c
[generic]                 1067    2684  39.8% -lh5- bee9 Jul  5 16:13 codesets/Developer/Examples/vastubs.c
[generic]                  346    1310  26.4% -lh5- 57d3 Jan 27  2007 codesets/Developer/fd/codesets_lib.fd
[generic]                 1095    3878  28.2% -lh5- 60f3 Jan 27  2007 codesets/Developer/include/clib/codesets_protos.h
[generic]                 1562    8242  19.0% -lh5- 8cd8 Jan 27  2007 codesets/Developer/include/inline/codesets.h
[generic]                 1481   12450  11.9% -lh5- 7a66 Jan 27  2007 codesets/Developer/include/inline/codesets_protos.h
[generic]                 1025    7727  13.3% -lh5- 3888 Jan 27  2007 codesets/Developer/include/inline4/codesets.h
[generic]                  817    5068  16.1% -lh5- 9465 Jan 27  2007 codesets/Developer/include/interfaces/codesets.h
[generic]                  446    2098  21.3% -lh5- b0db Jan 27  2007 codesets/Developer/include/interfaces/codesets.i
[generic]                 1928    6186  31.2% -lh5- 5433 Jul  6 07:12 codesets/Developer/include/libraries/codesets.h
[generic]                 1586    8399  18.9% -lh5- c9d4 Jan 27  2007 codesets/Developer/include/ppcinline/codesets.h
[generic]                 1414    6604  21.4% -lh5- 6eed Jan 27  2007 codesets/Developer/include/pragmas/codesets_pragmas.h
[generic]                  864    2384  36.2% -lh5- 2750 Jan 27  2007 codesets/Developer/include/proto/codesets.h
[generic]                  715    3433  20.8% -lh5- 9b1e Jan 27  2007 codesets/Developer/sfd/codesets_lib.sfd
[generic]                  916    6957  13.2% -lh5- e225 Jan 27  2007 codesets/Developer/xml/codesets.xml
[generic]                 1297    1646  78.8% -lh5- 9d83 Jan 27  2007 codesets/Libs.info
[generic]                28508  104860  27.2% -lh5- b7ec Jul  6 07:14 codesets/Libs/AmigaOS3/codesets.library
[generic]                47189  148008  31.9% -lh5- 58fa Jul  6 07:14 codesets/Libs/AmigaOS4/codesets.library
[generic]                36476  134748  27.1% -lh5- e312 Jul  6 07:14 codesets/Libs/MorphOS/codesets.library
[generic]                 2256    5070  44.5% -lh5- fb3f Jul  6 07:23 codesets/ReadMe
[generic]                  444     861  51.6% -lh5- 37c1 Jan 27  2007 codesets/ReadMe.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        58 files  368662 1055751  34.9%            Jul 31 07:18