Introduction
~~~~~~~~~~~~

This build is compiled and optimized for m68000 because standard version
requires at least a 68020 and this left out some users. For documentation
and catalogs check out main archive.

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 MorphOS (PPC).
In addition, it is available within the AROS project as a native ported
library.

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-68000.lha

2) copy the library out of the directory to your LIBS: directory.

   > copy codesets.library LIBS:

3) 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]                  707    1448  48.8% -lh5- ffec Jul 29  2007 authors
[generic]                 2957   10023  29.5% -lh5- 49dc Jan 27  2007 Charsets/ibm866.txt
[generic]                 1875    7079  26.5% -lh5- 4825 Jan 27  2007 Charsets/iso8859-10.txt
[generic]                 1902    6402  29.7% -lh5- 6ec8 Jan 27  2007 Charsets/iso8859-7.txt
[generic]                 2848   10671  26.7% -lh5- 6fc2 Jan 27  2007 Charsets/windows-1250.txt
[generic]                 2822    9311  30.3% -lh5- 36db Jan 27  2007 Charsets/windows-1251.txt
[generic]                 2904   10490  27.7% -lh5- f158 Jan 27  2007 Charsets/windows-1252.txt
[generic]                 2233    5024  44.4% -lh5- df0d Apr  2 19:59 codesets-68000.readme
[generic]                40135  130524  30.7% -lh5- e3fe Mar 31 14:15 codesets.library
[generic]                 8747   24351  35.9% -lh5- 64a8 Jan 27  2007 copying
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        10 files   67130  215323  31.2%            Apr  2 19:16