ICU-8856 Updated readme.html for 49M1

X-SVN-Rev: 30794
This commit is contained in:
Yoshito Umaoka 2011-10-04 20:05:56 +00:00
parent 9caf72ad89
commit 33a27b6625

View File

@ -13,12 +13,15 @@ h4.doc { text-decoration: underline }
<body style="background-color: rgb(255, 255, 255);" lang="EN-US" <body style="background-color: rgb(255, 255, 255);" lang="EN-US"
link="#0000ff" vlink="#800080"> link="#0000ff" vlink="#800080">
<h2>International Components for Unicode for Java (ICU4J)</h2> <h2>International Components for Unicode for Java (ICU4J)</h2>
<h3>Read Me for ICU4J 4.8</h3> <h3>Read Me for ICU4J 49 Milestone 1</h3>
(Last Update: May 19, 2011) (Last Update: Oct 4, 2011)
<hr size="2" width="100%"> <hr size="2" width="100%">
<p><b>Note:</b>This is major release of ICU4J. It contains bug fixes and adds implementations <p><b>Note:</b> This is a development milestone release of ICU4J 49.
of inherited API and introduces new API or functionality. The contents of this document may not reflect the recent changes done
for ICU 49 development. This milestone is inteneded for those wishing
to get an early look at ICU 4.8 new features and API changes. It is not
recommended for production use.
</p> </p>
<p>For the most recent release, see the <a <p>For the most recent release, see the <a
href="http://www.icu-project.org/download/"> ICU4J href="http://www.icu-project.org/download/"> ICU4J
@ -125,21 +128,11 @@ found in ICU4J.</p>
<h3 class="doc"><a name="changes"></a>Changes In This Release</h3> <h3 class="doc"><a name="changes"></a>Changes In This Release</h3>
<h4>New features and changes</h4> <h4>New features and changes</h4>
<p> <p>
See the <a href="http://sites.google.com/site/icusite/download/48">ICU 4.8 download page</a> about See the <a href="http://sites.google.com/site/icusite/download/49milestone">ICU 49 milestone download page</a> about
new features in this release. The list of API changes since the previous ICU4J release new features in this release. The list of API changes since the previous ICU4J release
is available is available
<a href="http://source.icu-project.org/repos/icu/icu4j/tags/release-4-8/APIChangeReport.html">here</a>. <a href="http://source.icu-project.org/repos/icu/icu4j/tags/milestone-49-0-1/APIChangeReport.html">here</a>.
</p> </p>
<h5>MessageFormat Changes</h5>
<p>MessageFormat and related classes (choice/plural/select) have been reimplemented,
with several improvements and some incompatible changes.
See the <a href="http://site.icu-project.org/download/48">ICU 4.8 download</a> page for details.</p>
<h5>Unknown system time zone - Etc/Unknown</h5>
The behavior of the time zone factory method TimeZone.getTimeZone(String) has changed in this release.
When an unknown time zone ID is specified in the method, previous versions return a TimeZone instance
with ID "GMT" (offset 0 and no daylight saving time). In ICU 4.8, the method uses "Etc/Unknown" as the
time zone ID (but still offset 0 and no daylight saving time) for the case. Existing software checking
the returned time zone ID to validate the input ID may need to be updated to support the new behavior.
<h3 class="doc"><a name="license"></a>License Information</h3> <h3 class="doc"><a name="license"></a>License Information</h3>
<p> <p>
The ICU projects (ICU4C and ICU4J) use the X license. The X The ICU projects (ICU4C and ICU4J) use the X license. The X
@ -167,7 +160,7 @@ package.
</p> </p>
<h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3> <h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
<p> <p>
ICU4J 4.8 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on ICU4J 49 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
JRE version 5.0 or later. JRE version 5.0 or later.
The table below shows the operating systems and JRE/VM versions currently The table below shows the operating systems and JRE/VM versions currently
used by the ICU development team to test ICU4J. used by the ICU development team to test ICU4J.
@ -814,54 +807,54 @@ from release to release, so clients should not depend on the exact
organization organization
of the data in ICU4J.</p> of the data in ICU4J.</p>
<ul> <ul>
<li>The primary <b>locale data</b> is under the directory <tt>icudt48b</tt>, <li>The primary <b>locale data</b> is under the directory <tt>icudt49b</tt>,
as a set of <tt>".res"</tt> files whose names are the locale identifiers. 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> 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 class, and the use of these names in searching for resources is documented
in <code>com.ibm.icu.util.UResourceBundle</code>.</li> in <code>com.ibm.icu.util.UResourceBundle</code>.</li>
<li>The <b>collation data</b> is under the directory <tt>icudt48b/coll</tt>, <li>The <b>collation data</b> is under the directory <tt>icudt49b/coll</tt>,
as a set of <tt>".res"</tt> files.</li> as a set of <tt>".res"</tt> files.</li>
<li>The <b>currency display name data</b> is under the directory <tt>icudt48b/curr</tt>, <li>The <b>currency display name data</b> is under the directory <tt>icudt49b/curr</tt>,
as a set of <tt>".res"</tt> files.</li> as a set of <tt>".res"</tt> files.</li>
<li>The <b>language display name data</b> is under the directory <tt>icudt48b/lang</tt>, <li>The <b>language display name data</b> is under the directory <tt>icudt49b/lang</tt>,
as a set of <tt>".res"</tt> files.</li> as a set of <tt>".res"</tt> files.</li>
<li>The <b>region display name data</b> is under the directory <tt>icudt48b/region</tt>, <li>The <b>region display name data</b> is under the directory <tt>icudt49b/region</tt>,
as a set of <tt>".res"</tt> files.</li> as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory <li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt48b/translit</tt>, as a set of <tt>".res"</tt> files.</li> <tt>icudt49b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based number format data</b> is under the directory <li>The <b>rule-based number format data</b> is under the directory
<tt>icudt48b/rbnf</tt>, as a set of <tt>".res"</tt> files. <tt>icudt49b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<li>The <b>break iterator data</b> is directly under the <li>The <b>break iterator data</b> is directly under the
directory <tt>icudt48b</tt>, as a set of <tt>".brk"</tt> files, named according to the directory <tt>icudt49b</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> type of break and the locale where there are locale-specific versions.</li>
<li>The <b>holiday data</b> is under the directory <tt>icudt48b</tt>, <li>The <b>holiday data</b> is under the directory <tt>icudt49b</tt>,
as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt> as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
followed by the locale ID.</li> followed by the locale ID.</li>
<li>The <b>character property data</b> and default <b>unicode collation algorithm <li>The <b>character property data</b> and default <b>unicode collation algorithm
(UCA) data</b> is found under the directory <tt>icudt48b</tt>, as a set of (UCA) data</b> is found under the directory <tt>icudt49b</tt>, as a set of
<tt>".icu"</tt> files. </li> <tt>".icu"</tt> files. </li>
<li>The <b>normalization data</b> is found under the directory <tt>icudt48b</tt>, <li>The <b>normalization data</b> is found under the directory <tt>icudt49b</tt>,
as a set of <tt>".nrm"</tt> files. </li> as a set of <tt>".nrm"</tt> files. </li>
<li>The <b>character set converter data</b> is under the directory <li>The <b>character set converter data</b> is under the directory
<tt>icudt48b</tt>, as a set of <tt>".cnv"</tt> files. These files are <tt>icudt49b</tt>, as a set of <tt>".cnv"</tt> files. These files are
currently included only in icu-charset.jar.</li> currently included only in icu-charset.jar.</li>
<li>The <b>time zone rule data</b> is under the directory <li>The <b>time zone rule data</b> is under the directory
<tt>icudt48b</tt>, as <tt>zoneinfo64.res</tt>.</li> <tt>icudt49b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<li>The <b>time zone display name data</b> is under the directory <li>The <b>time zone display name data</b> is under the directory
<tt>icudt48b/zone</tt>, as a set of <tt>".res"</tt> files.</li> <tt>icudt49b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
</ul> </ul>
<p> <p>
Some of the data files alias or otherwise reference data from other Some of the data files alias or otherwise reference data from other
@ -957,8 +950,8 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
<I> Note: This procedure assumes that all 3 sources are present</I> <I> Note: This procedure assumes that all 3 sources are present</I>
<ol> <ol>
<li>Checkout or download CLDR version 'release-2-0'</li> <li>Checkout or download CLDR version 'release-2-0'</li>
<li>Checkout ICU4C with tag 'release-4-8'</li> <li>Checkout ICU4C with tag 'milestone-49-0-1'</li>
<li>Checkout ICU4J with tag 'release-4-8'</li> <li>Checkout ICU4J with tag 'milestone-49-0-1'</li>
<li>cd to <I>$icu4c_root</I>/source/data directory</li> <li>cd to <I>$icu4c_root</I>/source/data directory</li>
<li>Follow the instructions in <I>$icu4c_root</I>/source/data/cldr-icu-readme.txt</li> <li>Follow the instructions in <I>$icu4c_root</I>/source/data/cldr-icu-readme.txt</li>
<li>Rebuild ICU4C with the newly generated data.</li> <li>Rebuild ICU4C with the newly generated data.</li>
@ -970,7 +963,7 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
</ol> </ol>
<h3 class="doc"><a name="timezone"></a>About ICU4J Time Zone</h3> <h3 class="doc"><a name="timezone"></a>About ICU4J Time Zone</h3>
<p>ICU4J 4.8 includes time zone data version 2011g, which is the latest one as of <p>ICU4J 49M1 includes time zone data version 2011k, which is the latest one as of
the release date. However, time zone data is frequently updated in response 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 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 the time zone data, please refer the ICU user guide topic