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

ICU-9722 Updated ICU4J readme.html for 51RC.

Browse Source 
X-SVN-Rev: 33370
This commit is contained in:
Yoshito Umaoka 2013-03-05 04:48:13 +00:00
parent bfcbce9ffb
commit 0136935f89
1 changed files with 42 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
icu4j/readme.html
View File

@ -15,11 +15,14 @@ h4.doc { text-decoration: underline }
link="#0000ff" vlink="#800080">
<h2>International Components for Unicode for Java (ICU4J)</h2>
<h3>Read Me for ICU4J 51</h3>
(Last Update: 2013-Feb-11)
(Last Update: 2013-Mar-4)
<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 major release of ICU4J. It contains bug fixes and adds implementations
of inherited API and introduces new API or functionality. -->
This is a release candidate version of ICU4J 51.
The contents of this document may not reflect the recent changes done
for ICU 51 development. 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,7 +131,7 @@ found in ICU4J.</p>
<p>See the <a href="http://sites.google.com/site/icusite/download/51">ICU 51 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-50-1/APIChangeReport.html">here</a>.</p>
<a href="http://source.icu-project.org/repos/icu/icu4j/tags/release-51-rc/APIChangeReport.html">here</a>.</p>
<h4>Date format pattern "V"</h4>
<p>The date format pattern "V" was introduced in ICU 3.8 (inherited from CLDR 1.5) as
@ -176,12 +179,12 @@ mean that projects using ICU become subject to GPL.
<p>
The IBM version contains the essential text of the license, omitting the
X-specific trademarks and copyright notices. The full copy of <a
href="main/shared/licenses/license.html">ICU's license</a> is included in the download
href="http://source.icu-project.org/repos/icu/icu4j/tags/release-51-rc/main/shared/licenses/license.html">ICU's license</a> is included in the download
package.
</p>
<h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
<p>
ICU4J 50 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
ICU4J 51 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.
@ -585,7 +588,15 @@ to all ICU4J API</a></li>
<a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/IslamicCalendar.html">Islamic</a>,
<a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/JapaneseCalendar.html">Japanese</a>.</li>
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/JapaneseCalendar.html">Japanese</a>,
Persian, Dangi.</li>
<li>Time Zone Enhancements &#8211;
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/BasicTimeZone.html">Time zone transition and rule detection</a>,
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/VTimeZone.html">iCalendar VTIMEZONE formatting and parsing</a>,
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/util/RuleBasedTimeZone.html">Custom time zones constructed by user defined rules</a>.
<li>Date Format Enhancements &#8211; <a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/DateTimePatternGenerator.html">Date/Time Pattern Generator</a>,
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/DateIntervalFormat.html">Date Interval Format</a>,
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/DurationFormat.html">Duration Format</a>.
<li><a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/Normalizer.html">Unicode
Normalization</a> &#8211; Canonical text representation for W3C.</li>
@ -604,11 +615,12 @@ e.g. Cyrillic to Latin, or Hex to Unicode. </li>
&amp; <a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/UnicodeDecompressor.html">Decompression</a>
&#8211; 2:1 compression on English Unicode text.</li>
<li>Collation - <a
<li>Collation &#8211; <a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/RuleBasedCollator.html">Rule-based
sorting</a>, <a
href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/StringSearch.html">Efficient
multi-lingual searching</a> </li>
multi-lingual searching</a>,
<a href="http://www.icu-project.org/apiref/icu4j/com/ibm/icu/text/AlphabeticIndex.html">Alphabetic indexing</a></li>
</ul>
<h3 class="doc"><a name="HowToInstallJavac"></a>How to Install and Build</h3>
<p>
@ -677,7 +689,7 @@ core:
[echo] compiler arg: -Xlint:all,-deprecation,-dep-ann,-options
[echo] ----------------------------------------------------
[mkdir] Created dir: C:\icu4j\main\classes\core\out\bin
[javac] Compiling 346 source files to C:\icu4j\main\classes\core\out\bin
[javac] Compiling 347 source files to C:\icu4j\main\classes\core\out\bin
[javac] Note: Some input files use or override a deprecated API.
[javac] Note: Recompile with -Xlint:deprecation for details.
@ -742,7 +754,7 @@ jar:
[copy] Copying 1 file to C:\icu4j
BUILD SUCCESSFUL
Total time: 1 minute 58 seconds</pre>
Total time: 2 minutes 12 seconds</pre>
</blockquote>
<I>Note: The above output is an example. The numbers are likely to be different with the current version ICU4J.</I>
<p>The following are some targets that you can provide to <b>ant</b>.
@ -851,54 +863,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>icudt50b</tt>,
<li>The primary <b>locale data</b> is under the directory <tt>icudt51b</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>icudt50b/coll</tt>,
<li>The <b>collation data</b> is under the directory <tt>icudt51b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>currency display name data</b> is under the directory <tt>icudt50b/curr</tt>,
<li>The <b>currency display name data</b> is under the directory <tt>icudt51b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>language display name data</b> is under the directory <tt>icudt50b/lang</tt>,
<li>The <b>language display name data</b> is under the directory <tt>icudt51b/lang</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>region display name data</b> is under the directory <tt>icudt50b/region</tt>,
<li>The <b>region display name data</b> is under the directory <tt>icudt51b/region</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt50b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt51b/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>icudt50b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<tt>icudt51b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<li>The <b>break iterator data</b> is directly under the
directory <tt>icudt50b</tt>, as a set of <tt>".brk"</tt> files, named according to the
directory <tt>icudt51b</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>icudt50b</tt>,
<li>The <b>holiday data</b> is under the directory <tt>icudt51b</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>icudt50b</tt>, as a set of
(UCA) data</b> is found under the directory <tt>icudt51b</tt>, as a set of
<tt>".icu"</tt> files. </li>
<li>The <b>normalization data</b> is found under the directory <tt>icudt50b</tt>,
<li>The <b>normalization data</b> is found under the directory <tt>icudt51b</tt>,
as a set of <tt>".nrm"</tt> files. </li>
<li>The <b>character set converter data</b> is under the directory
<tt>icudt50b</tt>, as a set of <tt>".cnv"</tt> files. These files are
<tt>icudt51b</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>icudt50b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<tt>icudt51b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<li>The <b>time zone display name data</b> is under the directory
<tt>icudt50b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt51b/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
@ -993,9 +1005,9 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
<h5> Generating Data from CLDR </h5>
<I> Note: This procedure assumes that all 3 sources are present</I>
<ol>
<li>Checkout or download CLDR version 'release-22-1'</li>
<li>Checkout ICU4C with tag 'release-50-1'</li>
<li>Checkout ICU4J with tag 'release-50-1'</li>
<li>Checkout or download CLDR version 'release-23-d02'</li>
<li>Checkout ICU4C with tag 'release-51-rc'</li>
<li>Checkout ICU4J with tag 'release-51-rc'</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>
@ -1007,7 +1019,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 50.1 includes time zone data version 2012h, which is the latest one as of
<p>ICU4J 51 Release Candidate includes time zone data version 2012j, 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