organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-19 11:45:45 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 3

ICU-1220 cleaned up README.

Browse source 
X-SVN-Rev: 7424
This commit is contained in:
Yves Arrouye 2002-01-09 20:52:18 +00:00
parent f271088377
commit 8f61ab0996
1 changed files with 11 additions and 58 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

69
icu4c/source/extra/uconv/README
View file

@ -1,60 +1,13 @@
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!
-----------------------------------------
The uconv command is an iconv(1)-like conversion / transcoding
program. Please check its manual page, or run uconv -h, for help.
Help, as well as error messages, are displayed through the use of a
resource bundle. Please contact Steven Loomis <srl@jtcsv.com> if you
want to offer a translation of these messages for a particular locale.
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>
uconv was originally written and contributed to icuapps by Jonas Utterström
<jonas.utterstrom@vittran.norrnod.se>, and offered simple conversion and
a way to know which encodings were available. It has since then be
moved to the main ICU distribution and converted to the C conversion
API, and is maintained by Yves Arrouye <yves@realnames.com> who seems
to always be looking for one more feature or option to add to the tool.