ICU-7585 Updated readme for 4.6M1.

X-SVN-Rev: 28241
This commit is contained in:
Yoshito Umaoka 2010-06-21 21:19:45 +00:00
parent c0875bf20f
commit c5521ac8b6

View File

@ -13,14 +13,17 @@ h4.doc { text-decoration: underline }
<body style="background-color: rgb(255, 255, 255);" lang="EN-US"
link="#0000ff" vlink="#800080">
<h2>International Components for Unicode for Java (ICU4J)</h2>
<h3>Read Me for ICU4J 4.4</h3>
<h3>Read Me for ICU4J 4.6M1</h3>
<hr size="2" width="100%">
<p><b>Release Date</b><br>
March 17, 2010<br>
June 23, 2010<br>
</p>
<p><b>Note:</b> This is major release of ICU4J. It contains bug fixes and adds implementations
of inherited API and introduces new API or functionality.
<p><b>Note:</b>This is a development milestone release of ICU4J 4.6.
The contents of this document may not reflect the recent changes done
for ICU 4.6 development. This milestone is inteneded for those wishing
to get an early look at ICU 4.6 new features and API changes. It is not
recommended for production use.
</p>
<p>For the most recent release, see the <a
href="http://www.icu-project.org/download/"> ICU4J
@ -128,43 +131,12 @@ current and complete version is always found in ICU4J.</p>
</blockquote>
<h3 class="doc"><a name="changes"></a>Changes In This Release</h3>
<h4>Minimum Java runtime environment requirement</h4>
<p>
Starting with version 4.4, you need at least JRE 5.0 to use ICU4J 4.4.
ICU4J adopted Java 5 language features and no longer compiles with JDK 1.4 or
older versions. This migration also includes some updates in public API signatures,
such as generics and return/parameter types. In general, most of these changes
do not require any changes in existing ICU4J user code.
</p>
<h4>TimeZone serialization compatibility</h4>
<p>
The new system time zone data format supporting 64bit transition time data
implemented in ICU4J 4.4 introduced a serialization incompatibility issue
in the internal TimeZone implementation class (e.g. An instance of TimeZone
created by <code>TimeZone.getTimeZone(String)</code> with an Olson tzid, such as
<code>"America/Los_Angeles"</code>).
The new implementation reads only the system time zone identifier string
when object data was serialized by ICU4J 4.2 or older versions. Also, ICU4J
4.2 or older versions cannot read object data created by ICU4J 4.4.
The system time zone implementation class may be used by other ICU4J
public API classes, such as <code>Calendar</code> and <code>DateFormat</code>,
therefore, these classes are also affected.
</p>
<p>
For the ICU4J serialization compatibility policy, please refer the user guide section
<a href="http://userguide.icu-project.org/design#TOC-ICU4J-Serialization-Compatibility">ICU4J
Serialization Compatibility</a>.
</p>
<h4>New features and other changes</h4>
<p>
See the <a href="http://icu-project.org/download/4.4.html">ICU 4.4 download page</a> about
See the <a href="http://sites.google.com/site/icusite/download/45">ICU 4.6 milestone download page</a> about
new features in this release. The list of API changes since the previous ICU4J release
is available
<a href="http://source.icu-project.org/repos/icu/icu4j/tags/release-4-4/APIChangeReport.html">here</a>.
<a href="http://source.icu-project.org/repos/icu/icu4j/tags/milestone-4-5-1/APIChangeReport.html">here</a>.
</p>
<h3 class="doc"><a name="license"></a>License Information</h3>
<p>
@ -193,7 +165,7 @@ package.
</p>
<h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
<p>
ICU4J 4.4 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
ICU4J 4.6 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
JRE version 5.0 or later.
The table below shows the operating systems and JRE/VM versions currently
used by the ICU development team to test ICU4J.
@ -896,52 +868,52 @@ from release to release, so clients should not depend on the exact
organization
of the data in ICU4J.</p>
<ul>
<li>The primary <b>locale data</b> is under the directory <tt>icudt44b</tt>,
<li>The primary <b>locale data</b> is under the directory <tt>icudt45b</tt>,
as a set of <tt>".res"</tt> files whose names are the locale identifiers.
Locale naming is documented the <code>com.ibm.icu.util.ULocale</code>
class, and the use of these names in searching for resources is documented
in <code>com.ibm.icu.util.UResourceBundle</code>.</li>
<li>The <b>collation data</b> is under the directory <tt>icudt44b/coll</tt>,
<li>The <b>collation data</b> is under the directory <tt>icudt45b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>currency display name data</b> is under the directory <tt>icudt44b/curr</tt>,
<li>The <b>currency display name data</b> is under the directory <tt>icudt45b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>language display name data</b> is under the directory <tt>icudt44b/lang</tt>,
<li>The <b>language display name data</b> is under the directory <tt>icudt45b/lang</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>region display name data</b> is under the directory <tt>icudt44b/region</tt>,
<li>The <b>region display name data</b> is under the directory <tt>icudt45b/region</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt44b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt45b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based number format data</b> is under the directory
<tt>icudt44b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<tt>icudt45b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<li>The <b>break iterator data</b> is directly under the
directory <tt>icudt44b</tt>, as a set of <tt>".brk"</tt> files, named according to the
directory <tt>icudt45b</tt>, as a set of <tt>".brk"</tt> files, named according to the
type of break and the locale where there are locale-specific versions.</li>
<li>The <b>holiday data</b> is under the directory <tt>icudt44b</tt>,
<li>The <b>holiday data</b> is under the directory <tt>icudt45b</tt>,
as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
followed by the locale ID.</li>
<li>The <b>character property data</b> as well as assorted <b>normalization
data</b> and default <b>unicode collation algorithm (UCA) data</b>
is found under the directory <tt>icudt44b</tt>, as a set of <tt>".icu"</tt>
is found under the directory <tt>icudt45b</tt>, as a set of <tt>".icu"</tt>
files. </li>
<li>The <b>character set converter data</b> is under the directory
<tt>icudt44b</tt>, as a set of <tt>".cnv"</tt> files. These files are
<tt>icudt45b</tt>, as a set of <tt>".cnv"</tt> files. These files are
currently included only in icu-charset.jar.</li>
<li>The <b>time zone rule data</b> is under the directory
<tt>icudt44b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<tt>icudt45b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<li>The <b>time zone display name data</b> is under the directory
<tt>icudt44b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt45b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
</ul>
<p>
Some of the data files alias or otherwise reference data from other
@ -1059,7 +1031,7 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
</ol>
<h3 class="doc"><a name="timezone"></a>About ICU4J Time Zone</h3>
<p>ICU4J 4.4 includes time zone data version 2010e, which is the latest one as of
<p>ICU4J 4.6M1 includes time zone data version 2010j, which is the latest one as of
the release date. However, time zone data is frequently updated in response
to changes made by local governments around the world. If you need to update
the time zone data, please refer the ICU user guide topic