blob: 020c91692a8bf28aa27a9f43edf9c3a9e31ef16c [file] [log] [blame]
Note: now has error messages, see root.txt.. more submissions wanted!
For now, we're just using OS level error messages for file access
email them to: srl@jtcsv.com thanks!
-----------------------------------------
uconv
=====
uconv demonstration example of ICU and codepage conversion.
The purpose is to be a replacement tool for the UNIX iconv program, and
to show how to use the class UnicodeConverterCPP.
Compiling
=========
See the README in the parent (icuapps) directory.
Running
=======
uconv converts files from one encoding to another. Just type uconv and it
will tell you the usage. It works similar to the iconv found in UNIX98
compliant systems.
TESTING uconv
=============
In the utf8 and charset directories you can find some texts, which you can use to test uconv
with. In the charset directory you can find texts encoded in different codepages.
Not all the codepages are supported by uconv yet, i.e. no euc* are supported.
Note on running the example in Linux/UNIX (1999)
================================================
The i18n support in Linux isn't as good as it should be, so to display other
than ISO-8859-x on your console means problems. But there is much work in
progress to eliminate this. In the meantime, please have a look at the
"UTF8 and Unicode FAQ for UNIX/Linux": http://www.cl.cam.ac.uk/~mgk25/unicode.html
To be able to display Unicode characters from far-away languages
you need a suitable font. The easiest is to use Roman Czyborra's free unicode
font. The font is not beautiful, but useful for testing purposes. Have a look at:
"Proposal for GNU Unicode font" http://czyborra.com/unifont/. This is
not a TrueType font so it won't work in Windows and on Macs.
Note on TMAKE (and those strange *.pro files)
=============================================
Maybe you noticed the *.pro file. This is a source-file for the
Makefile-generator tmake, which was written by Troll Tech.
It works in both UNIX and Windows, but you need to have Perl
installed. More information can be found on
http://www.troll.no/freebies/tmake.html.
Usage: tmake uconv.pro > Makefile
Hope this will get you going with the ICU library
Jonas Utterstrรถm <jonas.utterstrom@vittran.norrnod.se>