Text::Iconv Copyright © 2000 Michael Piotrowski. All Rights Reserved. This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Description ----------- This module provides a Perl interface to the XPG4 iconv() function. For more details see the POD documentation embedded in the file Iconv.pm, which will also be installed as Text::Iconv(3) man page. Prerequisites ------------- Your system should be compliant with XPG4 or at least provide iconv_open(), iconv() and iconv_close() functions compliant with XPG4. Note that the possible conversions and the quality of the conversions depend on the available iconv conversion tables and algorithms, which are in most cases supplied by the operating system vendor. Some systems also allow you to build your own tables (e.g., HP-UX, Digital UNIX, and AIX provide the genxlt(1) command). Building the module ------------------- Since XPG4 only specifies an interface, several issues are left to the implementation to define, namely: 1. The supported conversions 2. The supported character sets 3. The names for the supported character sets Please check your system documentation for the above points. You might also have to link in a special library (AIX seems to require this). If this is the case, add it to the list of needed libraries in Makefile.PL (e.g.: -liconv). You might also have to change the character set names which are used in the tests run by "make test". See test.pl. No changes are necessary for HP-UX systems. The module can now be built using this sequence of commands: perl Makefile.PL make make test Installation ------------ make install Feedback -------- Locale::iconv was only tested on HP-UX 10.20. If you are building the module on another architecture I would appreciate a note to tell me how you got on. It would also be good to know what conversions and character sets are supported by the different systems, so that the tests could automatically select conversions which are known to be supported on the specific system. Michael Piotrowski