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

ICU-9233 Updated ICU4J readme for 50m1

Browse Source 
X-SVN-Rev: 31987
This commit is contained in:
Yoshito Umaoka 2012-06-25 16:47:42 +00:00
parent 6f32f4f5a4
commit ab29fc782e
1 changed files with 28 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
icu4j/readme.html
View File

@ -13,12 +13,15 @@ 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 49.1</h3>
(Last Update: March 16, 2012)
<h3>Read Me for ICU4J 50 Milestone 1</h3>
(Last Update: June 25, 2012)
<hr size="2" width="100%">
<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 50.
The contents of this document may not reflect the recent changes done
for ICU 50 development. This milestone is intended for those wishing
to get an early look at ICU 50 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
@ -125,32 +128,9 @@ found in ICU4J.</p>
<h3 class="doc"><a name="changes"></a>Changes In This Release</h3>
<h4>New features and changes</h4>
<p>
See the <a href="http://sites.google.com/site/icusite/download/49">ICU 49 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-49-1/APIChangeReport.html">here</a>.
</p>
<h4>New ICU release version numbering</h4>
<p>
Starting this release, ICU release version numbering policy has changed to use a single
major version field(e.g. "49") as oppose to two fields (e.g. "4.8"). The second field stays 0
during development (e.g. "49.0.1" for ICU 49 development milestone 1) and the first official
release within a major version is 1 (e.g. "49.1"). For the details, please refer to <a
href="http://userguide.icu-project.org/design#TOC-Version-Numbers-in-ICU">Version Numbers
in ICU</a>.
</p>
<h4>Locale variant for ICU4J Locale Service Provider</h4>
<p>
ICU4J Locale Service Provider uses a special Locale variant value for overriding Java's
Locale service support. In this release, the default value of the special variant was
changed to "ICU4J" (previously, it was "ICU"). For example, with JDK Locale("en", "US", "ICU4J"),
ICU service implementation is used instead of Java's stock implementation for Locale("en", "US").
This change had made for BCP 47 conformance. The special variant value can be changed by
editing a properties file included in the ICU4J Locale Service Provider jar file.
Please see the user guide page <a href="http://userguide.icu-project.org/icu4j-locale-service-provider">
ICU4J Locale Service Provider</a> for the details.
See the <a href="http://sites.google.com/site/icusite/download/50milestone">ICU 50 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/milestone-50-0-1/APIChangeReport.html">here</a>.
</p>
<h3 class="doc"><a name="license"></a>License Information</h3>
@ -180,7 +160,7 @@ package.
</p>
<h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
<p>
ICU4J 49 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
ICU4J 50 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.
@ -845,54 +825,54 @@ 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>icudt49b</tt>,
<li>The primary <b>locale data</b> is under the directory <tt>icudt50b</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>icudt49b/coll</tt>,
<li>The <b>collation data</b> is under the directory <tt>icudt50b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>currency display name data</b> is under the directory <tt>icudt49b/curr</tt>,
<li>The <b>currency display name data</b> is under the directory <tt>icudt50b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>language display name data</b> is under the directory <tt>icudt49b/lang</tt>,
<li>The <b>language display name data</b> is under the directory <tt>icudt50b/lang</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>region display name data</b> is under the directory <tt>icudt49b/region</tt>,
<li>The <b>region display name data</b> is under the directory <tt>icudt50b/region</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt49b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt50b/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>icudt49b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<tt>icudt50b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<li>The <b>break iterator data</b> is directly under the
directory <tt>icudt49b</tt>, as a set of <tt>".brk"</tt> files, named according to the
directory <tt>icudt50b</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>icudt49b</tt>,
<li>The <b>holiday data</b> is under the directory <tt>icudt50b</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> and default <b>unicode collation algorithm
(UCA) data</b> is found under the directory <tt>icudt49b</tt>, as a set of
(UCA) data</b> is found under the directory <tt>icudt50b</tt>, as a set of
<tt>".icu"</tt> files. </li>
<li>The <b>normalization data</b> is found under the directory <tt>icudt49b</tt>,
<li>The <b>normalization data</b> is found under the directory <tt>icudt50b</tt>,
as a set of <tt>".nrm"</tt> files. </li>
<li>The <b>character set converter data</b> is under the directory
<tt>icudt49b</tt>, as a set of <tt>".cnv"</tt> files. These files are
<tt>icudt50b</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>icudt49b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<tt>icudt50b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<li>The <b>time zone display name data</b> is under the directory
<tt>icudt49b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt50b/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
@ -988,8 +968,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>
<ol>
<li>Checkout or download CLDR version 'release-21-0-1'</li>
<li>Checkout ICU4C with tag 'release-49-1'</li>
<li>Checkout ICU4J with tag 'release-49-1'</li>
<li>Checkout ICU4C with tag 'milestone-50-0-1'</li>
<li>Checkout ICU4J with tag 'milestone-50-0-1'</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>Rebuild ICU4C with the newly generated data.</li>
@ -1001,7 +981,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 49.1 includes time zone data version 2012b, which is the latest one as of
<p>ICU4J 50M1 includes time zone data version 2012c, 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