From 3dca31cccdbf2b444ab2775a6b1d8461ff380b87 Mon Sep 17 00:00:00 2001 From: Doug Felt Date: Fri, 27 Feb 2004 20:06:52 +0000 Subject: [PATCH] ICU-0 update readme X-SVN-Rev: 14610 --- icu4j/readme.html | 961 +++++++++++++++++++++------------------------- 1 file changed, 443 insertions(+), 518 deletions(-) diff --git a/icu4j/readme.html b/icu4j/readme.html index 564c4d0ed8..b362a5d16c 100644 --- a/icu4j/readme.html +++ b/icu4j/readme.html @@ -3,6 +3,7 @@ + ReadMe for ICU4J + + -

International Components for Unicode for Java

-

Read Me for ICU4J 2.8

+

International Components for Unicode for Java (ICU4J)

+

Read Me for ICU4J 3.0 - Draft

-
+

Release Date
- January 29th, 2004

+ TBD

For the most recent release, see the ICU4J download site.

-

Contents

+

Contents

-

Introduction to ICU4J (International Components for Unicode for Java)

+

Introduction to ICU4J

Today's global market demands programs that support a wide variety of languages and national conventions.  Customers prefer software @@ -88,7 +92,7 @@ Java. For example, the Thai word-break is now in Java 1.4. However, if you are using Java 1.3, you can use the ICU4J package until you upgrade to 1.4.

-

License Information

+

License Information

The ICU projects (ICU4C and ICU4J) use the X license.  The X license is a non-viral and recommended free software license that is compatible with the GNU GPL license.  This became effective with release 1.8.1 of ICU4C and release 1.3.1 of ICU4J in mid-2001. All new ICU releases will adopt the X license; previous ICU releases continue to utilize the IPL (IBM Public License).  Users of previous releases of ICU who want to adopt new ICU releases will need to accept the terms and conditions of the X license.

@@ -103,7 +107,7 @@ The text of the X license is available at htt For more details please see the press announcement and the Project FAQ.

-

Platform Dependencies

+

Platform Dependencies

Parts of ICU4J depend on functionality that is only available in JDK 1.3 or later, although some components work under earlier JVMs. All @@ -129,7 +133,7 @@ For more details please see the AIX 5.1, IBM JDK 1.3.1, 1.4.1 -

How to Download ICU4J

+

How to Download ICU4J

There are two ways to download the ICU4J releases. @@ -197,7 +201,7 @@ cvs logout href="http://oss.software.ibm.com/icu4j/download/index.html">http://oss.software.ibm.com/icu4j/download/index.html

-

The Structure and Contents of ICU4J

+

The Structure and Contents of ICU4J

Below, $Root is the placement of the icu directory in your file system, like "drive:\...\icu4j" in your environment. "drive:\..." stands for any @@ -205,40 +209,36 @@ drive and any directory on that drive that you chose to install icu4j into.

Information and build files:

- +
- - + - + + - - + + - - + + - - - - - - + +
readme.html
+ 		readme.html
(this file)		A description of ICU4J (International Components for Unicode for Java)A description of ICU4J (International Components for Unicode for Java)
releasenotes.html - A description of features and changes in this and prior releases of ICU4Jlicense.htmlThe X license, used by ICU4J
license.htmlThe X license, used by ICU4Jbuild.batA convenience bat file for building ICU4J with Ant on Windows
build.batA convenience bat file for building ICU4J with Ant on Windowsbuild.shA convenience sh file for building ICU4J with Ant on Unix
build.shA convenience sh file for building ICU4J with Ant on Unix
build.xmlAnt build file. See How to Install and Build for more informationbuild.xmlAnt build file. See How to Install and Build for more information

The source directories mirror the package structure of the code.
Core packages become part of the ICU4J jar file.
API packages contain classes with supported API.
RichText classes are Core and API, but can be removed from icu4j.jar, and can be built into their own jar.

- +
- - + - - + + - - + + - - + + - - + - - + - - +
$Root/src/com/ibm/icu/dev
Non-Core, Non-API		Packages used for internal development: + $Root/src/com/ibm/icu/dev
Non-Core, Non-API		Packages used for internal development:
  • Data: data used by tests and in building ICU
  • Demos: Calendar, Holiday, Break Iterator, Rule-based Number Format, Transformations
    (See below for more information about the demos.)
    • @@ -246,20 +246,20 @@ drive and any directory on that drive that you chose to install icu4j into.

  • Tools: tools used to build data tables, etc.
$Root/src/com/ibm/icu/impl
Core, Non-API		These are utility classes used from different ICU4J core packages.$Root/src/com/ibm/icu/impl
Core, Non-API		These are utility classes used from different ICU4J core packages.
$Root/src/com/ibm/icu/lang
Core, API		Character properties package.$Root/src/com/ibm/icu/lang
Core, API		Character properties package.
$Root/src/com/ibm/icu/math
Core, API		Additional math classes.$Root/src/com/ibm/icu/math
Core, API		Additional math classes.
$Root/src/com/ibm/icu/text
Core, API		Additional text classes. These add to, and in some cases replace, related core Java classes: + $Root/src/com/ibm/icu/text
Core, API		Additional text classes. These add to, and in some cases replace, related core Java classes:
  • Arabic shaping
  • Break iteration @@ -276,8 +276,8 @@ drive and any directory on that drive that you chose to install icu4j into.

$Root/src/com/ibm/icu/util
Core, API		Additional utility classes: + $Root/src/com/ibm/icu/util
Core, API		Additional utility classes:
  • Calendars - Gregorian, Buddhist, Hebrew, Islamic, Japanese
  • Holiday
    • @@ -288,8 +288,8 @@ drive and any directory on that drive that you chose to install icu4j into.

$Root/src/com/ibm/richtext
RichText		Styled text editing + $Root/src/com/ibm/richtext
RichText		Styled text editing package. This includes demos, tests, and GUIs for editing and displaying styled text. The richtext package provides a scrollable display, typing, arrow-key support, tabs, alignment and @@ -301,35 +301,33 @@ drive and any directory on that drive that you chose to install icu4j into.

-

Building ICU4J creates and populates the following directories:

+

Building ICU4J creates and populates the following directories:

- +
- - + + - - + +
$Root/classescontains all class files$Root/classescontains all class files
$Root/doccontains JavaDoc for all packages$Root/doccontains JavaDoc for all packages
+
+

ICU4J data is stored in the following locations:

-

Data organization:

- -

ICU4J data is stored in the following locations: - - +
- - + + - - + +
com.ibm.icu.impl.dataHolds data used by the ICU4J core packages (com.ibm.icu.lang, com.ibm.icu.text, com.ibm.icu.util, com.ibm.icu.math and com.ibm.icu.text). In particular, all resource information is stored here.com.ibm.icu.impl.dataHolds data used by the ICU4J core packages (com.ibm.icu.lang, com.ibm.icu.text, com.ibm.icu.util, com.ibm.icu.math and com.ibm.icu.text). In particular, all resource information is stored here.
com.ibm.icu.dev.dataHolds data that is not part of ICU4J core, but rather part of a test, sample, or demo.com.ibm.icu.dev.dataHolds data that is not part of ICU4J core, but rather part of a test, sample, or demo.
- -

Where to get Documentation

+
+

Where to get Documentation

The ICU user's guide contains lots of general information about ICU, in its C, C++, and Java incarnations.

@@ -354,11 +352,14 @@ drive and any directory on that drive that you chose to install icu4j into.

  • Collation - Rule-based sorting, Efficient multi-lingual searching
    • -

    How to Install and Build

    +

    How to Install and Build

    To install ICU4J, simply place the prebuilt jar file icu4j.jar on your Java CLASSPATH.  No other files are needed.

    +

    Eclipse users: See the ICU4J site for information on +how to configure Eclipse to build ICU4J.

    +

    To build ICU4J, you will need a Java2 JDK and the Ant build system. We strongly recommend using the Ant build system to build ICU4J:

    @@ -401,73 +402,70 @@ Compiling 24 source files to F:\icu4j\classes Completed in 19 seconds -

    The following are some targets that you can give after ant. For more +

    The following are some targets that you can provide to ant. For more targets, see the build.xml file:

    -
    - - +
    - - + + - - + - - + + - - + + - - + + - - + - - + - - + - - + - - + - - + - - + - - + +
    allBuild all targets.allBuild all targets.
    coreBuild the main class files in the subdirectory classes. If no target + coreBuild the main class files in the subdirectory classes. If no target is specified, core is assumed.
    testsBuild the test class files.testsBuild the test class files.
    demosBuild the demos.demosBuild the demos.
    toolsBuild the tools.toolsBuild the tools.
    docsRun javadoc over the main class files, generating an HTML documentation tree in the + docsRun javadoc over the main class files, generating an HTML documentation tree in the subdirectory doc.
    jarCreate a jar archive icu4j.jar in the root ICU4J directory containing + jarCreate a jar archive icu4j.jar in the root ICU4J directory containing the main class files.
    jarSrcLike the jar target, but containing only the source files. + jarSrcLike the jar target, but containing only the source files.
    jarDocsLike the jar target, but containing only the docs. + jarDocsLike the jar target, but containing only the docs.
    richeditBuild the richedit core class files and tests. + richeditBuild the richedit core class files and tests.
    richeditJarCreate the richedit jar file (which contains only the richedit core class files). + richeditJarCreate the richedit jar file (which contains only the richedit core class files). The file richedit.jar will be created in the ./richedit subdirectory. Any existing file of that name will be overwritten.
    richeditZipCreate a zip archive of the richedit docs and jar file for distribution. The zip file richedit.zip + richeditZipCreate a zip archive of the richedit docs and jar file for distribution. The zip file richedit.zip will be created in the ./richedit subdirectory. Any existing file of that name will be overwritten.
    cleanRemove all built targets, leaving the source.cleanRemove all built targets, leaving the source.
    -

    For more information, read the Ant documentation and the build.xml file.

    @@ -480,424 +478,345 @@ Ant you can build by running javac and javadoc directly. This is not recommended. You may have to manually create destination directories.)

    -

    How to modularize ICU4J

    -Some applications and environments may not wish to ship all of ICU4J bundled as a jar file since the jar file is large and may contain parts of ICU4J which are not used. -Some applications use only a particular service from the range of services that ICU4J offers, so would want to ship only that service as a jar file. -Since ICU4J release 2.6, new build options are provided to select individual ICU4J modules for a more compact jar distribution. -The modules are divided on basis of service and set of APIs required for supporting that service,e.g., -the normalizer module supports all the Normalizer APIs.The self tests for these APIs can be run to verify that the APIs work. -Even though a number of supporting classes are compiled containing other APIs, no guarantees are made that these APIs will work. -The modules are interdependent not independent,i.e., separate modules are not built into separate jars, instead one or more module targets are specified inorder to build a smaller jar. - +

    How to modularize ICU4J

    +

    Some clients may not wish to ship all of ICU4J with their application, since the application might only use a small part of ICU4J. +ICU4J release 2.6 and later provide build options to build individual ICU4J 'modules' for a more compact distribution. +The modules are based on a service and the APIs that define it, e.g., +the normalizer module supports all the APIs of the Normalizer class (and some others). +Tests can be run to verify that the APIs supported by the module function correctly. +Because of internal code dependencies, a module contains extra classes that are not part of the module's core service API. +Some or most of the APIs of these extra classes will not work. Only the module's core service API is +guaranteed. Other APIs may work partially or not at all, so client code should avoid them.

    +

    +Individual modules are not built directly into their own separate jar files. Since their dependencies +often overlap, using separate modules to 'add on' ICU4J functionality would result in +unwanted duplication of class files. Instead, building a module causes a subset of ICU4J's +classes to be built and put into ICU4J's standard +build directory. After one or more module targets are built, the 'moduleJar' target can then be +built, which packages the class files into a 'module jar.' Other than the fact that it +contains fewer class files, little distinguishes this jar file from a full ICU4J jar file, +and in fact they share the same name.

    +

    Currently ICU4J can be divided into the following modules: -

    - +

    + +

    Key:
    +

    + + + + + + + + +
    Module NameAnt TargetsTest Package SupportedSize
    + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + +
    Module NameAnt TargetsTest Package SupportedMain Classes*†Size
    Normalizernormalizer, normalizerTestscom.ibm.icu.dev.test.normalizer - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    text.Normalizer     -
    text.Replaceable -
    text.ReplaceableString -
    text.UCharacterIterator -
    text.UForwardCharacterIterator     -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.ValueIterator -
    util.VersionInfo -     		 355 KB
    Collatorcollator, collatorTestscom.ibm.icu.dev.test.collator - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    text.BreakDictionary -
    text.BreakIterator -
    text.BreakIteratorFactory -
    text.CanonicalIterator -
    text.CollationElementIterator -
    text.CollationKey -
    text.CollationParsedRuleBuilder -
    text.CollationRuleParser -
    text.Collator -
    text.CollatorReader     -
    text.DictionaryBasedBreakIterator -
    text.Normalizer     -
    text.Replaceable -
    text.ReplaceableString -
    text.RuleBasedBreakIterator -
    text.RuleBasedCollator -
    text.SearchIterator -
    text.StringSearch     -
    text.UCharacterIterator -
    text.UForwardCharacterIterator     -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.ValueIterator -
    util.VersionInfo -     		1,716 KB
    Calendarcalendar, calendarTestscom.ibm.icu.dev.test.calendar - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    math.BigDecimal     -
    text.BreakIterator -
    text.ChineseDateFormat -
    text.ChineseDateFormatSymbols -
    text.DateFormat -
    text.DateFormatSymbols -
    text.DecimalFormat -
    text.DecimalFormatSymbols     -
    text.Normalizer -
    text.NumberFormat -
    text.Replaceable -
    text.ReplaceableString -
    text.SimpleDateFormat -
    text.UCharacterIterator -
    text.UForwardCharacterIterator     -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.BuddhistCalendar -
    util.Calendar -
    util.CalendarAstronomer -
    util.CalendarCache -
    util.CalendarFactory -
    util.ChineseCalendar -
    util.Currency -
    util.DateRule -
    util.EasterHoliday -
    util.EasterRule -
    util.GregorianCalendar -
    util.HebrewCalendar -
    util.HebrewHoliday -
    util.Holiday -
    util.IslamicCalendar -
    util.JapaneseCalendar -
    util.RangeDateRule -
    util.SimpleDateRule -
    util.SimpleHoliday -
    util.SimpleTimeZone -
    util.SimpleTimeZoneAdapter -
    util.TimeZone -
    util.TimeZoneData     -
    util.ValueIterator -
    util.VersionInfo -     		1,160 KB
     BreakIteratorbreakIterator, breakIteratorTestscom.ibm.icu.dev.test.breakiterator - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    text.BreakDictionary -
    text.BreakIterator -
    text.BreakIteratorFactory -
    text.DictionaryBasedBreakIterator     -
    text.Normalizer -
    text.Replaceable -
    text.ReplaceableString -
    text.RuleBasedBreakIterator     -
    text.UCharacterIterator -
    text.UForwardCharacterIterator -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.RangeValueIterator -
    util.ValueIterator -
    util.VersionInfo -     		1,105 KB
    Basic PropertiespropertiesBasic, propertiesTestscom.ibm.icu.dev.test.lang - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    lang.UScriptRun     -
    text.BreakDictionary -
    text.BreakIterator -
    text.BreakIteratorFactory -
    text.DictionaryBasedBreakIterator -
    text.Normalizer -
    text.Replaceable -
    text.ReplaceableString -
    text.RuleBasedBreakIterator -
    text.SymbolTable -
    text.UCharacterIterator -
    text.UForwardCharacterIterator -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16     -
    util.CompactByteArray -
    util.RangeValueIterator -
    util.ValueIterator -
    util.VersionInfo -     		350 KB
    Full PropertiespropertiesFull, -
    propertiesTests    		com.ibm.icu.dev.test.lang - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    lang.UScriptRun     -
    text.BreakDictionary -
    text.BreakIterator -
    text.BreakIteratorFactory -
    text.DictionaryBasedBreakIterator -
    text.Normalizer -
    text.Replaceable -
    text.ReplaceableString     -
    text.RuleBasedBreakIterator -
    text.UCharacterIterator -
    text.UForwardCharacterIterator -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.RangeValueIterator -
    util.ValueIterator -
    util.VersionInfo     -     		 986 KB
    Formattingformat, formatTestscom.ibm.icu.dev.test.format - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    math.BigDecimal     -
    text.BreakIterator -
    text.CanonicalIterator -
    text.ChineseDateFormat -
    text.ChineseDateFormatSymbols -
    text.CollationElementIterator -
    text.CollationKey -
    text.CollationParsedRuleBuilder -
    text.CollationRuleParser -
    text.Collator -
    text.CollatorReader -
    text.DateFormat -
    text.DateFormatSymbols -
    text.DecimalFormat -
    text.DecimalFormatSymbols     -
    text.Normalizer -
    text.NumberFormat     -
    text.Replaceable -
    text.ReplaceableString -
    text.RuleBasedCollator -
    text.RuleBasedNumberFormat -
    text.SimpleDateFormat -
    text.UCharacterIterator -
    text.UForwardCharacterIterator     -
    text.UnicodeFilter -
    text.UnicodeMatcher -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.Calendar -
    util.CalendarAstronomer -
    util.CalendarCache -
    util.CalendarFactory -
    util.ChineseCalendar -
    util.Currency -
    util.GregorianCalendar -
    util.RangeValueIterator -
    util.SimpleTimeZone -
    util.SimpleTimeZoneAdapter -
    util.TimeZone -
    util.TimeZoneData     -
    util.ValueIterator -
    util.VersionInfo -     		1,788 KB
    Transformstransliterator, transliteratorTestscom.ibm.icu.dev.test.translit - lang.UCharacter -
    lang.UCharacterCategory -
    lang.UCharacterDirection -
    lang.UCharacterNameIterator -
    lang.UCharacterTypeIterator -
    lang.UProperty -
    lang.UScript -
    lang.UScriptRun -
    text.AnyTransliterator -
    text.BreakDictionary -
    text.BreakIterator -
    text.BreakIteratorFactory -
    text.BreakTransliterator -
    text.DictionaryBasedBreakIterator -
    text.Normalizer -
    text.Replaceable -
    text.ReplaceableString -
    text.RuleBasedBreakIterator -
    text.StringReplacer -
    text.Transliterator -
    text.UCharacterIterator -
    text.UForwardCharacterIterator -
    text.UnicodeSet -
    text.UnicodeSetIterator -
    text.UTF16 -
    util.RangeValueIterator -
    util.ValueIterator -
    util.VersionInfo     -     		1,364 KBPackage*Main Classes† +
    +
    -* com.ibm.icu. should be prepended to the names listed. -
    † APIs contained by class names in bold are guaranteed to work. +* com.ibm. should be prepended to the package names listed. +
    † A bold class name core service APIs. Only APIs +in these classes are fully supported.     -
    -
    +

    +

    Modules:
    + + + + + + + + + + -Building any of these modules is as easy as specifying a build target to the Ant build system,e.g: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Normalizernormalizer, normalizerTestscom.ibm.icu.dev.test.normalizer355 KB
    + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, + UCharacterNameIterator, UCharacterTypeIterator, UProperty, UScript
    icu.text:Normalizer, Replaceable, ReplaceableString, UCharacterIterator, + UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, UnicodeSet, + UnicodeSetIterator, UTF16
    icu.util:ValueIterator, VersionInfo
    +
    Collatorcollator, collatorTestscom.ibm.icu.dev.test.collator1,716 KB
    + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, + UCharacterNameIterator, UCharacterTypeIterator, lang.UProperty, UScript +
    icu.text:BreakDictionary, BreakIterator, BreakIteratorFactory, + CanonicalIterator, CollationElementIterator, CollationKey, + CollationParsedRuleBuilder, CollationRuleParser, Collator, + CollatorReader, DictionaryBasedBreakIterator, Normalizer, + Replaceable, ReplaceableString, RuleBasedBreakIterator, RuleBasedCollator, + SearchIterator, StringSearch, UCharacterIterator, + UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, UnicodeSet, + UnicodeSetIterator, UTF16 +
    icu.util:ValueIterator, VersionInfo +
    +
    Calendarcalendar, calendarTestscom.ibm.icu.dev.test.calendar1,160 KB
    + + + + + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, UCharacterNameIterator, + UCharacterTypeIterator, UProperty, UScript +
    icu.math:BigDecimal +
    icu.text:BreakIterator, ChineseDateFormat, ChineseDateFormatSymbols, + DateFormat, DateFormatSymbols, DecimalFormat, DecimalFormatSymbols, + Normalizer, NumberFormat, Replaceable, ReplaceableString, SimpleDateFormat, + UCharacterIterator, UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, + UnicodeSet, UnicodeSetIterator, UTF16 +
    icu.util:BuddhistCalendar, Calendar, CalendarAstronomer, + CalendarCache, CalendarFactory, ChineseCalendar, Currency, + DateRule, EasterHoliday, EasterRule, GregorianCalendar, + HebrewCalendar, HebrewHoliday, Holiday, IslamicCalendar, + JapaneseCalendar, RangeDateRule, SimpleDateRule, SimpleHoliday, + SimpleTimeZone, SimpleTimeZoneAdapter, TimeZone, TimeZoneData, + ValueIterator, VersionInfo +
    +
    BreakIteratorbreakIterator, breakIteratorTestscom.ibm.icu.dev.test.breakiterator1,105 KB
    + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, + UCharacterNameIterator, UCharacterTypeIterator, UProperty, UScript +
    icu.text:BreakDictionary, BreakIterator, BreakIteratorFactory, + DictionaryBasedBreakIterator, Normalizer, Replaceable, ReplaceableString, + text.RuleBasedBreakIterator, UCharacterIterator, UForwardCharacterIterator, + UnicodeFilter, UnicodeMatcher, UnicodeSet, UnicodeSetIterator, UTF16 +
    icu.util:RangeValueIterator, ValueIterator, VersionInfo +
    +
    Basic PropertiespropertiesBasic, propertiesTestscom.ibm.icu.dev.test.lang350 KB
    + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, + UCharacterNameIterator, UCharacterTypeIterator, UProperty, UScript, + UScriptRun +
    icu.text:BreakDictionary, BreakIterator, BreakIteratorFactory, DictionaryBasedBreakIterator, + Normalizer, Replaceable, ReplaceableString, RuleBasedBreakIterator, SymbolTable, UCharacterIterator, + UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, UnicodeSet, UnicodeSetIterator, UTF16 +
    icu.util:CompactByteArray, RangeValueIterator, ValueIterator, VersionInfo +
    +
    Full PropertiespropertiesFull, propertiesTestscom.ibm.icu.dev.test.lang986 KB
    + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, + UCharacterNameIterator, UCharacterTypeIterator, UProperty, UScript, + UScriptRun +
    icu.text:BreakDictionary, BreakIterator, BreakIteratorFactory, DictionaryBasedBreakIterator, + Normalizer, Replaceable, ReplaceableString, RuleBasedBreakIterator, + UCharacterIterator, UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, + UnicodeSet, UnicodeSetIterator, UTF16 +
    icu.util:RangeValueIterator, ValueIterator, VersionInfo +
    +
    Formattingformat, formatTestscom.ibm.icu.dev.test.format1,788 KB
    + + + + + + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, UCharacterDirection, UCharacterNameIterator, + UCharacterTypeIterator, UProperty, UScript +
    icu.math:math.BigDecimal +
    icu.text:BreakIterator, CanonicalIterator, ChineseDateFormat, ChineseDateFormatSymbols, + CollationElementIterator, CollationKey, CollationParsedRuleBuilder, CollationRuleParser, Collator, + CollatorReader, DateFormat, DateFormatSymbols, DecimalFormat, DecimalFormatSymbols, + Normalizer, NumberFormat, Replaceable, ReplaceableString, RuleBasedCollator, + RuleBasedNumberFormat, SimpleDateFormat, UCharacterIterator, + UForwardCharacterIterator, UnicodeFilter, UnicodeMatcher, UnicodeSet, UnicodeSetIterator, UTF16 +
    icu.util:Calendar, CalendarAstronomer, CalendarCache, CalendarFactory, + ChineseCalendar, Currency, GregorianCalendar, RangeValueIterator, + SimpleTimeZone, SimpleTimeZoneAdapter, TimeZone, TimeZoneData, + ValueIterator,VersionInfo +
    +
    Transformstransliterator, transliteratorTestscom.ibm.icu.dev.test.translit1,364 KB
    + + + + + + + + + + + + +
    icu.lang:UCharacter, UCharacterCategory, + UCharacterDirection, UCharacterNameIterator, + UCharacterTypeIterator, UProperty, UScript, + UScriptRun +
    icu.text:AnyTransliterator, BreakDictionary, + BreakIterator, BreakIteratorFactory, BreakTransliterator, + DictionaryBasedBreakIterator, Normalizer, Replaceable, + ReplaceableString, RuleBasedBreakIterator, StringReplacer, + Transliterator, UCharacterIterator, UForwardCharacterIterator, + UnicodeSet, UnicodeSetIterator, UTF16 + +
    icu.util:RangeValueIterator, ValueIterator, + VersionInfo +
    +
    +

    + +

    Building any of these modules is as easy as specifying a build target to the Ant build system,e.g:
    To build a module that contains only the Normalizer API:

    1. Build the module.
      ant normalizer
      2. @@ -914,11 +833,11 @@ If more than one module is required, the module build targets can be concatenate
    2. Run the tests and verify that the self tests pass.
      java -classpath $icu4j_root/classes com.ibm.icu.dev.test.TestAll -nothrow -w
    3. Build the jar containing the module.
      ant moduleJar
    - +

    Notes:
    -

    Trying Out ICU4J

    +

    Trying Out ICU4J

    Note: the demos provided with ICU4J are for the most part undocumented. This list can show you where to look, but you'll @@ -975,9 +894,7 @@ one of the following:

    - -

    ICU4J Resource Information

    -     +

    ICU4J Resource Information

    Starting with release 2.1, ICU4J includes its own resource information which is completely independent of the JDK resource information. The @@ -1050,10 +967,17 @@ the remaining resources, making sure each required resource is present.

    -

    Developing Resources to be used with ICU4J

    +

    Using additional resource files with ICU4J

    + +
    +
    Warning: Resource +file formats can change across releases of ICU4J!
    The format of ICU4J resources is not part of the API. Clients who +develop their own resources for use with ICU4J should be prepared to +regenerate them when they move to new releases of ICU4J.
    +

    ICU4J 2.1 and above uses the standard class lookup mechanism. This means -any ppropriately named resource on the CLASSPATH will be located, in the +any appropriately named resource on the CLASSPATH will be located, in the order listed in the classpath.

    @@ -1101,7 +1025,8 @@ resource files to understand the contents of the ICU4J resources, as they are the same.

    -

    Developing ICU4J Resources

    +

    Developing ICU4J resource files

    +

    Currently only the LocaleElements resource data is shared, other ICU resources (calendar, transliterator, etc.) are still checked in @@ -1165,9 +1090,7 @@ overwrite any corresponding .class files already in that directory. class file in $icu_root\source\data\locales\java. The ICULocaleData.jar is moved to $icu4j_root\src\com\ibm\icu\impl\data directory. -

    Where to Find More Information

    - -

    For information specific to this current release, please refer to the releasenotes.html

    +

    Where to Find More Information

    http://oss.software.ibm.com/icu4j/ is a pointer to general information about the International Components for Unicode in Java

    @@ -1175,19 +1098,21 @@ pointer to general information about the International Components for Unicode in

    http://www.ibm.com/developer/unicode is a pointer to information on how to make applications global.

    -

    Submitting Comments, Requesting Features and -Reporting Bugs

    +

    Submitting Comments, Requesting Features and +Reporting Bugs

    Your comments are important to making ICU4J successful.  We are committed to fixing any bugs, and will use your feedback to help plan future releases.

    To submit comments, request features and report bugs, contact us through the ICU4J mailing list.
    While we are not able to respond individually to each comment, we do review all comments.

    -

    Thanks for your interest in ICU4J!

    +

    +

    Thank you for your interest in ICU4J!

    +
    -

    Copyright © 2002-2003 International Business Machines Corporation and others. All Rights +

    Copyright © 2002-2004 International Business Machines Corporation and others. All Rights Reserved.
    5600 Cottle Road, San José, CA 95193