AuroraMiddleware/scuffed-code
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

updated bad link to download page

Browse Source 
X-SVN-Rev: 981
This commit is contained in:
John Fitzpatrick 2000-03-24 00:04:00 +00:00
parent 05d0b518f6
commit 5563d13b38
1 changed files with 379 additions and 444 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

823
icu4j/readme.html
View File

@ -1,12 +1,13 @@
<!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="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]">
<meta name="Originator" content="Microsoft Word 9">
<meta name="Template" content="F:\Program Files\Microsoft Office\Office\html.dot">
<title>ReadMe for ICU</title>
<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]>
@ -286,449 +287,383 @@ ul
<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">
<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>
Version: February 1, 2000
<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>
COPYRIGHT:
<br>Copyright (c) 2000 International Business Machines Corporation and
others. All Rights Reserved.
<div class="MsoNormal" style="text-align:center">
<hr size="2" width="100%" align="center"></div>
<dd>
</dd>
<br>&nbsp;
<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>
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>
Your comments are important to making this release successful.&nbsp; We
are committed to fixing any bugs, and will also use your feedback to help
plan future releases.
<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>&nbsp;
<br>&nbsp;
<h3>
<a NAME="WhatContain"></a><u>What the International Components for Unicode
for Java Contain</u></h3>
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>
<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.&nbsp; These versions are tested more thoroughly than day-to-day development
builds, and they are packaged in zip and tar files for convenient download.&nbsp;
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.&nbsp; It will re-construct the source directory.
<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>
<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>
<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 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>
<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.&nbsp;&nbsp;&nbsp; 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 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>
<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</ul>
</ul>
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/project/download/index.html">http:/oss.software.ibm.com/developerworks/opensource/icu4j/project/download/index.html</a>
<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>&nbsp;
<p><b>The following files describe the code drop:</b>
<br>&nbsp;
<br>&nbsp;
<table BORDER 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">readme.html (this file)</div>
</td>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">describes the International Components for Unicode
for Java</div>
</td>
</tr>
<tr>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">license.html</div>
</td>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">contains IBM's public license</div>
</td>
</tr>
</table>
<p><b>The source directories mirror package structure of the code.&nbsp;
The following directories contain source code and data files:</b>
<br>&nbsp;
<br>&nbsp;
<table BORDER 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">$Root/src/data/</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">Various data files used to generate ICU4J classes.&nbsp;
Most of the files contain Unicode information that is available from <a href="http://www.unicode.org/">http://www.unicode.org/</a>.&nbsp;
Used only by tools in the src/com/ibm/tools.</div>
</td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Root/src/com/ibm/demo</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">Demonstration applications and Applets.</div>
</td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Root/src/com/ibm/test</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">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>.</div>
</td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Roo/src/com/ibm/tools</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">Various tools used to generate ICU4J classes.&nbsp;
<a href="docs/cintltst.html">$Root/src/com/ibm/tools</a></div>
</td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Root/src/com/ibm/text</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">The following components:&nbsp;
<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">$Root/src/com/ibm/util</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">Calendars and Holidays</div>
</td>
</tr>
<tr>
<td WIDTH="20%" style="width:20.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Root/build</div>
</td>
<td WIDTH="80%" style="width:80.0%;padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">Additional classes needed to build using Ant</div>
</td>
</tr>
</table>
<p><b>The following directories are populated when you've built everything:</b>
<br>&nbsp;
<br>&nbsp;
<table BORDER 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">$Root/classes/</div>
</td>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">contains all class files</div>
</td>
</tr>
<tr>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">$Root/docs</div>
</td>
<td style="padding:.75pt .75pt .75pt .75pt">
<div class="MsoNormal">contains JavaDoc for all packages</div>
</td>
</tr>
</table>
<h3>
<a NAME="API"></a><u>API Overview</u></h3>
The complete API documentation is available on the ICU4J web sight:
<br>&nbsp;
<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>
&amp; <a href="javadoc/com/ibm/text/UnicodeDecompressor.html">Decompression</a>
– 2:1 compression on English Unicode text</li>
<dd>
</dd>
<br>&nbsp;
<h3>
<a NAME="PlatformDependencies"></a><u>Platform Dependencies</u></h3>
Parts of ICU4J depend on functionality that is only available in Java2
(JDk1.2) or later, although some components work under 1.1.&nbsp; 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.&nbsp; Currently 1.1.x is unsupported and untested and you
use the components on a 1.1.x system at your own risk.
<h3>
<a NAME="HowToInstallJavac"></a><u>How to Install/Build using Javac</u></h3>
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>Create a folder named "classes" in the icu4j forlder.
<p>Run the buildall.bat script by typing "buildall" (or "buildall.bat"
from Unix) to build all the classes in ICU4J.&nbsp; Note that the script
simply calls javac so the java compiler must be in your path for the script
to work correctly.&nbsp; The resulting class files will be put in the "classes"
directory.
<h3>
<a NAME="HowToInstallAnt"></a><u>How to Install/Build using Ant</u></h3>
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>Ant is a Java based build system developed for the Jakarta (part of
Apache) project.&nbsp; 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>&nbsp;
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>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>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>At this point it is probably a good idea to run all the tests by typeing
"java -classpath classes com.ibm.test.topleveltest.TestAll".
<h3>
<a NAME="WhereToFindMore"></a><u>Where to Find More Information</u></h3>
<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><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>&nbsp;
<h3>
<a NAME="SubmittingComments"></a><u>Submitting Comments, Requesting Features
and Reporting Bugs</u></h3>
To submit comments, request features and report bugs, please contact us.&nbsp;
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>.
<div class="MsoNormal" style="text-align:center">
<hr size="2" width="100%" align="center"></div>
Copyright &copy; 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.
<div class="MsoNormal" style="text-align:center">
<hr size="2" width="100%" align="center"></div>
<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>&nbsp;</dd>
<dd><br>
&nbsp; <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 &#150; 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 &#150; 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 &#150; 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 &#150; 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 &#150; 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 &#150; 2:1 compression on English Unicode text</li>
</ul>
<p>Your comments are important to making this release successful.&nbsp; 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>
&nbsp; <br>
&nbsp; </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>&nbsp;</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.&nbsp; These versions are tested
more thoroughly than day-to-day development builds, and they are packaged in zip and tar
files for convenient download.&nbsp; 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.&nbsp; 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>&nbsp;</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>&nbsp;</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>&nbsp;</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
&quot;:pserver:anoncvs@oss.software.ibm.com:/usr/cvs/icu4j&quot; <br>
with the password &quot;anoncvs&quot;. To enter the CVSRoot value, select
&quot;Preferences&quot; from the &quot;Cvs Admin&quot; pull-down menu.&nbsp;&nbsp;&nbsp;
Authentication should be set to &quot;'passwd' file on the cvs server&quot;. <br>
3.To &quot;extract&quot; the most recent version of ICU4J, select &quot;Checkout
module&quot; from the &quot;Cvs Admin&quot; menu. Specify &quot;icu4j&quot; 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>&nbsp;</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
&quot;drive:\...\icu4j&quot; in your environment. &quot;drive:\...&quot; stands for any
drive and any directory on that drive that you chose to install icu4j into. <br>
&nbsp; </p>
<p><b>The following files describe the code drop:</b> <br>
&nbsp; <br>
&nbsp; </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.&nbsp; The following
directories contain source code and data files:</b> <br>
&nbsp; <br>
&nbsp; </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.&nbsp; Most of the files contain Unicode
information that is available from <a href="http://www.unicode.org/">http://www.unicode.org/</a>.&nbsp;
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.&nbsp; <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:&nbsp; </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>
&nbsp; <br>
&nbsp; </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>
&nbsp; </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 &#150; <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> &#150; 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> &#150;
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> &#150;
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> &#150; 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> &amp; <a
href="javadoc/com/ibm/text/UnicodeDecompressor.html">Decompression</a> &#150; 2:1
compression on English Unicode text</li>
<dd>&nbsp;</dd>
<dd><br>
&nbsp; <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.&nbsp; 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.&nbsp; 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
&quot;unzip -a icu4j-XXX.zip -d drive:\directory&quot; under the command prompt. </p>
<p>Create a folder named &quot;classes&quot; in the icu4j forlder. </p>
<p>Run the buildall.bat script by typing &quot;buildall&quot; (or &quot;buildall.bat&quot;
from Unix) to build all the classes in ICU4J.&nbsp; Note that the script simply calls
javac so the java compiler must be in your path for the script to work correctly.&nbsp;
The resulting class files will be put in the &quot;classes&quot; 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
&quot;unzip -a icu4j-XXX.zip -d drive:\directory&quot; under the command prompt. </p>
<p>Ant is a Java based build system developed for the Jakarta (part of Apache)
project.&nbsp; 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>&nbsp;
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 &quot;unzip -a jakarta-ant.zip&quot; <br>
Type &quot;Build all&quot; or &quot;Build.sh all&quot; under Unix. </p>
<p>The resulting classes are put in the &quot;classes&quot; directory, the JavaDoc is put
in the &quot;docs&quot; 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 &quot;java
-classpath classes com.ibm.test.topleveltest.TestAll&quot;. </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>
&nbsp; </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.&nbsp; 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 © 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>