Short: Character conversions and codesets Author: codesets.library Open Source Team Uploader: jcagigal gmail com Type: util/libs Version: 6.8 Requires: AmigaOS 3.0+, 68000 Architecture: m68k-amigaos >= 3.0 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...