From 87a5062c6c7f5e09cfccdf5c43b25509747ba182 Mon Sep 17 00:00:00 2001 From: George Rhoten Date: Fri, 2 Apr 2004 01:32:00 +0000 Subject: [PATCH] ICU-3650 Fix some comments on the icuswap tool and toolutil. X-SVN-Rev: 14841 --- icu4c/readme.html | 57 ++++++++++++++++++++++++++++++++--------------- 1 file changed, 39 insertions(+), 18 deletions(-) diff --git a/icu4c/readme.html b/icu4c/readme.html index 0e8dc1c0845..c32d97ad1c6 100644 --- a/icu4c/readme.html +++ b/icu4c/readme.html @@ -2,6 +2,7 @@ + ReadMe for ICU @@ -1494,7 +1495,8 @@ del common/libicuuc.so libicui18n.so.XY.Z - Contains many locale based i18n functions. + A library that contains many locale based internationalization + (i18n) functions. @@ -1504,7 +1506,7 @@ del common/libicuuc.so libicule.so.XY.Z - Contains an optional engine for doing font layout. + An optional engine for doing font layout. @@ -1514,8 +1516,8 @@ del common/libicuuc.so libiculx.so.XY.Z - Contains an optional engine for doing font layout that uses parts - of ICU. + An optional engine for doing font layout that uses parts of + ICU. @@ -1523,10 +1525,22 @@ del common/libicuuc.so icuioXY.dll - libustdio.so.XY.Z + libicuio.so.XY.Z - An unsupported optional library that provides a stdio like API with - Unicode support. + An optional library that provides a stdio like API with Unicode + support. + + + + Tool Utility Library + + icutuXY.dll + + libicutu.so.XY.Z + + An internal library that contains internal APIs that are only used + by ICU's tools. If you do not use ICU's tools, you do not need this + library. @@ -1954,22 +1968,29 @@ del common/libicuuc.so

Data For a New Platform

-

It may not be necessary for your use of ICU to make a full ICU build - work. Most of the makefiles and build targets are for tools that are used - for building ICU's data, and an application's data, if the application uses - ICU resource bundles and similar for its data.

+

For some people, it may not be necessary for completely build ICU. Most + of the makefiles and build targets are for tools that are used for building + ICU's data, and an application's data (when an application uses ICU + resource bundles for its data).

-

Data files can be built on a different platform if both platforms share - the same endianness and the same charset family, and if memory-mappable, - binary data files are used instead of DLLs/shared libraries. For details +

Data files can be built on a different platform when both platforms + share the same endianness and the same charset family. This assertion does + not include platform dependent DLLs/shared/static libraries. For details see the User Guide ICU Data chapter.

-

ICU 2.8 eliminates the first condition: It adds the icuswap tool which - can be run on any platform to turn binary ICU data files from any one of - the three formats into any one of the other. This allows to use ICU data - built anywhere to be used for any target platform.

+

ICU 2.8 removes the requirement that ICU be completely built in the + native operating environment. It adds the icuswap tool which can be run on + any platform to turn binary ICU data files from any one of the three + formats into any one of the other data formats. This allows a application + to use ICU data built anywhere to be used for any other target + platform.

+ +

WARNING! Building ICU without running the tests is not + recommended. The tests verify that ICU is safe to use. It is recommended + that you try to completely port and test ICU before using the libraries for + your own application.

Adapting Makefiles For a New Platform