<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="ProgId" content="Word.Document">
<meta name="GENERATOR" content="Microsoft FrontPage 3.0">
<meta name="Originator" content="Microsoft Word 9">
<meta name="Template" content="F:\Program Files\Microsoft Office\Office\html.dot">
<title>ReadMe for ICU</title>
<link rel="File-List" href="readme_files/filelist.xml">
<link rel="Edit-Time-Data" href="readme_files/editdata.mso">
<!--[if !mso]>
<style>
v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style>
<![endif]-->
<!--[if gte mso 9]><xml>
<o:DocumentProperties>
<o:Author>Helena Shih</o:Author>
<o:Template>Normal</o:Template>
<o:LastAuthor>Helena Shih</o:LastAuthor>
<o:Revision>4</o:Revision>
<o:TotalTime>28</o:TotalTime>
<o:Created>2000-02-01T18:26:00Z</o:Created>
<o:LastSaved>2000-02-09T20:02:00Z</o:LastSaved>
<o:Pages>11</o:Pages>
<o:Words>5177</o:Words>
<o:Characters>29510</o:Characters>
<o:Company>IBM</o:Company>
<o:Lines>245</o:Lines>
<o:Paragraphs>59</o:Paragraphs>
<o:CharactersWithSpaces>36240</o:CharactersWithSpaces>
<o:Version>9.2720</o:Version>
</o:DocumentProperties>
</xml><![endif]-->
<style>
<!--
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;
text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;
text-underline:single;}
p
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
pre
{margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt;
font-size:10.0pt;
font-family:"Courier New";
mso-fareast-font-family:"Courier New";}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:47188065;
mso-list-type:hybrid;
mso-list-template-ids:1466486202 116280834 552215838 906805068 1521137622 401357620 -1378838014 -511129794 450771094 1606707228;}
@list l1
{mso-list-id:117913232;
mso-list-type:hybrid;
mso-list-template-ids:-450314456 413984474 -860879584 458148388 1916146286 1538412862 863017768 -300143966 -55386208 -1462483600;}
@list l1:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l2
{mso-list-id:283392397;
mso-list-type:hybrid;
mso-list-template-ids:221802328 -258441084 -934746342 1419537734 -1901567532 1981813236 287487774 2029678266 1193441118 -320863984;}
@list l3
{mso-list-id:568229750;
mso-list-type:hybrid;
mso-list-template-ids:1260177520 158890492 503090804 -1695902632 1465945538 -935272554 -2049028 941654354 -1871965178 -1305592270;}
@list l3:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l4
{mso-list-id:576742058;
mso-list-type:hybrid;
mso-list-template-ids:-715868556 -132768664 498237874 598241330 -1517910766 -1750947490 714492842 1225816080 -2059080712 393093814;}
@list l4:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l5
{mso-list-id:664672491;
mso-list-type:hybrid;
mso-list-template-ids:1772678752 2062991906 446980294 -161209628 -100250862 2128757756 2052650808 -538035208 -6270306 291808606;}
@list l5:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l6
{mso-list-id:836961509;
mso-list-type:hybrid;
mso-list-template-ids:-224895454 -1014200752 826189550 -2031309554 1889069730 -609042030 1875430626 1998766280 1070782366 1076102286;}
@list l6:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l7
{mso-list-id:913508786;
mso-list-type:hybrid;
mso-list-template-ids:1568069976 -1959095566 -768301796 -931790726 -2143009482 1948575304 -712632468 -697775276 -403279512 968792852;}
@list l7:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l7:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:"Courier New";
mso-bidi-font-family:"Times New Roman";}
@list l8
{mso-list-id:991719643;
mso-list-type:hybrid;
mso-list-template-ids:2129591196 1460462400 -1172699750 1169610458 -437120214 1872653486 -842923700 841514964 2136911810 1364103300;}
@list l9
{mso-list-id:1115171434;
mso-list-type:hybrid;
mso-list-template-ids:-1407672820 -1016529878 1566456998 -99162944 1112470608 1354390290 1532235962 643100262 1447355994 -1094388302;}
@list l10
{mso-list-id:1133790422;
mso-list-type:hybrid;
mso-list-template-ids:602321612 -1181957080 -1020131346 -1755803318 646190636 122975578 1475804658 -455318736 -1891325090 -1214717408;}
@list l10:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l10:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:"Courier New";
mso-bidi-font-family:"Times New Roman";}
@list l11
{mso-list-id:1170366750;
mso-list-type:hybrid;
mso-list-template-ids:139625938 1784856908 14434230 2135990762 205005018 -1679018944 -78496528 941265532 136326846 -2030939902;}
@list l12
{mso-list-id:1395081028;
mso-list-type:hybrid;
mso-list-template-ids:-1450152516 594060610 -1995156862 -742472460 1399253788 775304844 -332753902 -90000986 -656356064 -1128074476;}
@list l12:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l13
{mso-list-id:1410885180;
mso-list-type:hybrid;
mso-list-template-ids:-1420239212 -2078642128 1381369862 486155864 -1973497194 1050204580 -46207730 -508368526 1735818270 669444066;}
@list l13:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l14
{mso-list-id:1558080398;
mso-list-type:hybrid;
mso-list-template-ids:-720580774 1417685988 1440894936 -1423303424 -193586832 898255738 -212563752 725117368 1124212432 2069772174;}
@list l14:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l15
{mso-list-id:1927837791;
mso-list-type:hybrid;
mso-list-template-ids:1363567226 -2132220750 875589078 1199445854 -582346952 944043046 -49528938 -394654148 1636605060 -183584940;}
@list l15:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
@list l15:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:"Courier New";
mso-bidi-font-family:"Times New Roman";}
@list l16
{mso-list-id:2067096185;
mso-list-type:hybrid;
mso-list-template-ids:582122176 -1729593526 -491090842 -1692663546 -1673229800 1254113432 1459242370 292878442 -961933704 -1788173682;}
@list l16:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.5in;
mso-level-number-position:left;
text-indent:-.25in;
mso-ansi-font-size:10.0pt;
font-family:Symbol;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1027"/>
</xml><![endif]-->
<!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1"/>
</o:shapelayout></xml><![endif]-->
</head>
<body bgcolor="#FFFFFF" link="#0000FF" vlink="#800080" lang="EN-US"
style="tab-interval:.5in">
<div class="Section1">
<h2>ReadMe: International Components for Unicode for Java</h2>
<p>Version: February 1, 2000 </p>
<div class="MsoNormal" style="text-align:center">
<hr size="2" width="100%" align="center">
</div>
<p>COPYRIGHT: <br>
Copyright (c) 2000 International Business Machines Corporation and others. All Rights
Reserved. </p>
<div class="MsoNormal" style="text-align:center">
<hr size="2" width="100%" align="center">
</div>
<dd> </dd>
<dd><br>
<h3><u>Contents</u></h3>
<ul type="disc">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#introduction">Introduction</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#WhatContain">What the International Components for Unicode for Java Contain</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#API">API overview</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#PlatformDependencies">Platform Dependencies</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#HowToInstallJavac">How to Install/Build using Javac</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#HowToInstallAnt">How to Install/Build using Ant</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#WhereToFindMore">Where to Find More Information</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l3 level1 lfo3;tab-stops:list .5in"><a
href="#SubmittingComments">Submitting Comments, Requesting Features and Reporting Bugs</a></li>
</ul>
<h3><a NAME="introduction"></a><u>Introduction</u></h3>
<p>Today's software market is a global one in which it is desirable to develop and
maintain one application that supports a wide variety of national languages. International
Components for Unicode for Java provides the following tools to help you write language
independent applications: <ul type="disc">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">International
Calendars – Arabic, Buddhist, Hebrew, Japanese</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Unicode
Normalization – Canonical text representation for W3C</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Number
Format Enhancements – Scientific Notation, Spelled-out, ...</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Enhanced
word-break detection – Rule-based, supports Thai</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Unicode
Text Searching – Efficient multi-lingual searching</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Unicode
Text Compression – 2:1 compression on English Unicode text</li>
</ul>
<p>Your comments are important to making this release successful. We are committed
to fixing any bugs, and will also use your feedback to help plan future releases. </p>
<p style="margin-right:.5in;margin-left:.5in"><b><u>IMPORTANT</u>: Please make sure you
understand the <a href="license.html">Copyright and License information</a>.</b> <br>
<br>
</p>
<h3><a NAME="WhatContain"></a><u>What the International Components for Unicode for Java
Contain</u></h3>
<p>There are two ways to download the ICU4J releases, <ul type="disc">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l10 level1 lfo9;tab-stops:list .5in"><b>Official
Release Snapshot:</b></li>
<li> </li>
<li><br>
If you want to use ICU4J (as opposed to developing it), your best bet is to download an
official, packaged ICU4J version of the ICU4J source code. These versions are tested
more thoroughly than day-to-day development builds, and they are packaged in zip and tar
files for convenient download. These packaged files can be found at <a
href="http://oss.software.ibm.com/developerworks/opensource/icu4j/download/index.html">http://oss.software.ibm.com/developerworks/opensource/icu4j/download/index.html</a>.
<br>
If packaged snapshot is named <b>ICU4JXXXXXX.zip </b>, XXXXXX is the release version
number. <br>
Please unzip this file. It will re-construct the source directory. </li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l10 level1 lfo9;tab-stops:list .5in"><b>CVS
Source Repository:</b></li>
<li> </li>
<li><br>
If you are interested in developing features, patches, or bug fixes for ICU4J, you should
probably be working with the latest version of the ICU4J source code. You will need to
check the code out of our CVS repository to ensure that you have the most recent version
of all of the files. There are several ways to do this: <ul type="circle">
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;mso-list:l10 level2 lfo9;tab-stops:list 1.0in">WebCVS:</li>
<li> </li>
<li><br>
If you want to browse the code and only make occasional downloads, you may want to use
WebCVS. It provides a convenient, web-based interface for browsing and downloading the
latest version of the ICU4J source code and documentation. You can also view each file's
revision history, display the differences between individual revisions, determine which
revisions were part of which official release, and so on. </li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;mso-list:l10 level2 lfo9;tab-stops:list 1.0in">WinCVS:</li>
<li> </li>
<li><br>
If you will be doing serious work on ICU4J, you should probably install a CVS client on
your own machine so that you can do batch operations without going through the WebCVS
interface. On Windows, we suggest the WinCVS client. The following is the example
instruction on how to download ICU4J via WinCVS: <br>
1.Install the WinCVS client, which you can download from the WinCVS home page. <br>
2.In the WinCVS preferences, specify your CVSRoot to be
":pserver:anoncvs@oss.software.ibm.com:/usr/cvs/icu4j" <br>
with the password "anoncvs". To enter the CVSRoot value, select
"Preferences" from the "Cvs Admin" pull-down menu.
Authentication should be set to "'passwd' file on the cvs server". <br>
3.To "extract" the most recent version of ICU4J, select "Checkout
module" from the "Cvs Admin" menu. Specify "icu4j" for the module
name. </li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;mso-list:l10 level2 lfo9;tab-stops:list 1.0in">CVS
command line:</li>
<li> </li>
<li><br>
You can also check out the repository anonymously on UNIX using the following commands,
after first setting your CVSROOT to point to the ICU4J repository: <p>export
CVSROOT=:pserver:anoncvs@oss.software.ibm.com:/usr/cvs/icu4j <br>
cvs login CVS password: anoncvs <br>
cvs checkout icu4j <br>
cvs logout</p>
</li>
</ul>
</li>
</ul>
<p>For more details on how to download ICU4J directly from the web site, please also see <a
href="http://oss.software.ibm.com/developerworks/opensource/icu4j/download/index.html">http:/oss.software.ibm.com/developerworks/opensource/icu4j/download/index.html</a>
</p>
<p>Below, <b>$Root</b> is the placement of the icu directory in your file system, like
"drive:\...\icu4j" in your environment. "drive:\..." stands for any
drive and any directory on that drive that you chose to install icu4j into. <br>
</p>
<p><b>The following files describe the code drop:</b> <br>
<br>
</p>
<table BORDER="1" CELLPADDING="0"
style="mso-cellspacing:1.5pt;mso-padding-alt:
0in 0in 0in 0in">
<tr>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>readme.html (this
file)</p>
</div></td>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>describes the
International Components for Unicode for Java</p>
</div></td>
</tr>
<tr>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>license.html</p>
</div></td>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>contains IBM's
public license</p>
</div></td>
</tr>
</table>
<p><b>The source directories mirror package structure of the code. The following
directories contain source code and data files:</b> <br>
<br>
</p>
<table BORDER="1" CELLPADDING="0" WIDTH="623"
style="width:467.25pt;mso-cellspacing:
1.5pt;mso-padding-alt:0in 0in 0in 0in">
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/src/data/</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Various
data files used to generate ICU4J classes. Most of the files contain Unicode
information that is available from <a href="http://www.unicode.org/">http://www.unicode.org/</a>.
Used only by tools in the src/com/ibm/tools.</p>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/src/com/ibm/demo</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Demonstration
applications and Applets.</p>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/src/com/ibm/test</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Tests
for various ICU4J components.. For information about running the tests, see <a
href="api/com/ibm/test/topleveltest/TestAll.html">$Root/docs/com/ibm/test/topleveltest/TestAll.html</a>.</p>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Roo/src/com/ibm/tools</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Various
tools used to generate ICU4J classes. <a href="docs/cintltst.html">$Root/src/com/ibm/tools</a></p>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/src/com/ibm/text</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>The
following components: </p>
<li>RuleBasedBreakIterator</li>
<li>DictionaryBasedBreakIterator</li>
<li>Transliterator</li>
<li>Normalizer</li>
<li>BigNumberFormat</li>
<li>StringSearch</li>
<li>Unicode compression</li>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/src/com/ibm/util</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Calendars
and Holidays</p>
</div></td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/build</p>
</div></td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>Additional
classes needed to build using Ant</p>
</div></td>
</tr>
</table>
<p><b>The following directories are populated when you've built everything:</b> <br>
<br>
</p>
<table BORDER="1" CELLPADDING="0"
style="mso-cellspacing:1.5pt;mso-padding-alt:
0in 0in 0in 0in">
<tr>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/classes/</p>
</div></td>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>contains all class
files</p>
</div></td>
</tr>
<tr>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>$Root/docs</p>
</div></td>
<td style="padding:.75pt .75pt .75pt .75pt"><div class="MsoNormal"><p>contains JavaDoc for
all packages</p>
</div></td>
</tr>
</table>
<h3><a NAME="API"></a><u>API Overview</u></h3>
<p>The complete API documentation is available on the ICU4J web sight: <br>
</p>
</dd>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in"><a
href="javadoc/index.html">Complete index</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">International
Calendars – <a href="javadoc/com/ibm/util/IslamicCalendar.html">Islamic</a>, <a
href="javadoc/com/ibm/util/BuddhistCalendar.html">Buddhist</a>, <a
href="javadoc/com/ibm/util/HebrewCalendar.html">Hebrew</a>, <a
href="javadoc/com/ibm/util/JapaneseCalendar.html">Japanese</a></li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in"><a
href="javadoc/com/ibm/text/Normalizer.html">Unicode Normalization</a> – Canonical
text representation for W3C</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in"><a
href="javadoc/com/ibm/text/NumberFormat.html">Number Format Enhancements</a> –
Scientific Notation, Spelled-out, ...</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in"><a
href="javadoc/com/ibm/text/BreakIterator.html">Enhanced word-break detection</a> –
Rule-based, supports Thai</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in"><a
href="javadoc/com/ibm/text/StringSearch.html">Unicode Text Searching</a> – Efficient
multi-lingual searching</li>
<li class="MsoNormal"
style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
mso-list:l5 level1 lfo6;tab-stops:list .5in">Unicode
Text <a href="javadoc/com/ibm/text/UnicodeCompressor.html">Compression</a> & <a
href="javadoc/com/ibm/text/UnicodeDecompressor.html">Decompression</a> – 2:1
compression on English Unicode text</li>
<dd> </dd>
<dd><br>
<h3><a NAME="PlatformDependencies"></a><u>Platform Dependencies</u></h3>
<p>Parts of ICU4J depend on functionality that is only available in Java2 (JDk1.2) or
later, although some components work under 1.1. However, all components should be
compiled using a Java2 compiler as even components that run using a 1.1.x JVM may require
language features that are only present in 1.2. Currently 1.1.x is unsupported and
untested and you use the components on a 1.1.x system at your own risk. </p>
<h3><a NAME="HowToInstallJavac"></a><u>How to Install/Build using Javac</u></h3>
<p>To install the ICU4J source code simply unzip the icu4j-XXX.zip file by typing
"unzip -a icu4j-XXX.zip -d drive:\directory" under the command prompt. </p>
<p>Create a folder named "classes" in the icu4j forlder. </p>
<p>Run the buildall.bat script by typing "buildall" (or "buildall.bat"
from Unix) to build all the classes in ICU4J. Note that the script simply calls
javac so the java compiler must be in your path for the script to work correctly.
The resulting class files will be put in the "classes" directory. </p>
<h3><a NAME="HowToInstallAnt"></a><u>How to Install/Build using Ant</u></h3>
<p>To install the ICU4J source code simply unzip the icu4j-XXX.zip file by typing
"unzip -a icu4j-XXX.zip -d drive:\directory" under the command prompt. </p>
<p>Ant is a Java based build system developed for the Jakarta (part of Apache)
project. It can be downloaded from the Jakarta websight at: <a
href="http://jakarta.apache.org/downloads/binindex.html">http://jakarta.apache.org/downloads/binindex.html.</a>
Download the latest Jakarta-tools archive (<a
href="http://jakarta.apache.org/builds/tomcat/release/v3.1_beta_1/bin/jakarta-tools.tar.gz">http://jakarta.apache.org/builds/tomcat/release/v3.1_beta_1/bin/jakarta-ant.zip</a>).
</p>
<p>The steps for installing Ant are: <br>
Move the Jakarta-ant.zip file into the root ICU4J folder (at the same level with the src
and build folders). <br>
Unzip the tools into the ICU4J root folder, type "unzip -a jakarta-ant.zip" <br>
Type "Build all" or "Build.sh all" under Unix. </p>
<p>The resulting classes are put in the "classes" directory, the JavaDoc is put
in the "docs" directory, and a jar file is put in the top ICU4J directory. </p>
<p>At this point it is probably a good idea to run all the tests by typeing "java
-classpath classes com.ibm.test.topleveltest.TestAll". </p>
<h3><a NAME="WhereToFindMore"></a><u>Where to Find More Information</u></h3>
<p><a href="http://oss.software.ibm.com/icu4j">http://oss.software.ibm.com/icu4j</a> is a
pointer to general information about the International Components for Unicode in Java </p>
<p><a href="http://www.ibm.com/unicode">http://www.ibm.com/unicode</a> is a pointer to
information on how to make applications global. <br>
</p>
<h3><a NAME="SubmittingComments"></a><u>Submitting Comments, Requesting Features and
Reporting Bugs</u></h3>
<p>To submit comments, request features and report bugs, please contact us. While we
are not able to respond individually to each comment, we do review all comments. Send
Internet email to <a href="mailto:icu4j@oss.software.ibm.com">icu4j@oss.software.ibm.com</a>.
</p>
<div class="MsoNormal" style="text-align:center"><hr size="2" width="100%" align="center">
</div><p>Copyright <20> 2000 International Business Machines Corporation and others. All
Rights Reserved. <br>
IBM Center for Java Technology Silicon Valley, <br>
10275 N De Anza Blvd., Cupertino, CA 95014 <br>
All rights reserved. </p>
<div class="MsoNormal" style="text-align:center"><hr size="2" width="100%" align="center">
</div></dd>
</div>
</body>
</html>
