scuffed-code/icu4c/source/extra/uconv
2001-10-31 18:43:45 +00:00
..
samples ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
unicode ICU-1220 Better help format. Removed releaseBuffer() calls. 2001-09-21 00:30:25 +00:00
.cvsignore ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
makedata.mak ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
Makefile.in ICU-1404 configure, fix broken --with-data-packaging option 2001-10-31 18:43:45 +00:00
pkgdata.inc.in ICU-1254 Simplify the build process 2001-10-03 23:32:12 +00:00
README ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
resfiles.mk ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
root.txt ICU-1220 Better help format. Removed releaseBuffer() calls. 2001-09-21 00:30:25 +00:00
uconv.cpp ICU-1220 Better help format. Removed releaseBuffer() calls. 2001-09-21 00:30:25 +00:00
uconv.dsp ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
uconv.dsw ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
uconv.pro ICU-1220 Added uconv as an extra (Unix only for now). 2001-09-19 23:43:16 +00:00
uwmsg.c ICU-900 Fixed some compiler warnings. 2001-10-10 16:45:32 +00:00

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<74>m <jonas.utterstrom@vittran.norrnod.se>