Skip to content

Commit

Permalink
ICU-20979 BRS67RC Updating ICU4J readme
Browse files Browse the repository at this point in the history 
For now, just updating version to 67, but not mentioning it's RC, so we don't need another update.

I also updated all dead ICU user guide links.
  • Loading branch information
@yumaoka
yumaoka committed Apr 1, 2020
1 parent d0f2aa6 commit 4807a89
Showing 1 changed file with 45 additions and 48 deletions.
93 changes: 45 additions & 48 deletions icu4j/readme.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,23 +14,23 @@
<body style="background-color: rgb(255, 255, 255);" lang="EN-US"
link="#0000ff" vlink="#800080">
<h1>International Components for Unicode for Java (ICU4J)</h1>
<h2>Read Me for ICU4J 66.1</h2>
(Last Update: 2020-Mar-02)
<h2>Read Me for ICU4J 67.1</h2>
(Last Update: 2020-Apr-1)
<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.
<!-- <b>Note:</b> This is a preview release of ICU4J 66.
<!-- <b>Note:</b> This is a preview release of ICU4J 67.
The contents of this document may not reflect the recent changes done
for ICU 66 development. It is not recommended for production use. -->
<!-- <b>Note:</b> This is a development milestone of ICU4J 66.
for ICU 67 development. It is not recommended for production use. -->
<!-- <b>Note:</b> This is a development milestone of ICU4J 67.
The contents of this document may not reflect the recent changes done
for ICU 66 development. It is not recommended for production use. -->
<!-- <b>Note:</b> This is a release candidate of ICU4J 66.
for ICU 67 development. It is not recommended for production use. -->
<!-- <b>Note:</b> This is a release candidate of ICU4J 67.
The contents of this document may not reflect the recent changes done
for ICU 66 development. This release candidate is intended for those
wishing to verify ICU 66 integration before final release. It is not
for ICU 67 development. This release candidate is intended for those
wishing to verify ICU 67 integration before final release. It is not
recommended for production use. -->
</p>
<p>For the most recent release, see the <a
Expand Down Expand Up @@ -76,60 +76,60 @@ <h2 class="doc"><a name="introduction"></a>Introduction to ICU4J</h2>
</p>
<ul>
<li><a
href="http://www.icu-project.org/userguide/Collate_Intro.html"><b>Collation</b></a>
href="http://userguide.icu-project.org/collation"><b>Collation</b></a>
&#8211; rule-based, up-to-date Unicode Collation Algorithm (UCA) sorting order<br>
&nbsp;&nbsp;&nbsp;&nbsp;For fast multilingual string comparison; faster
and more complete than
the J2SE implementation</li>
<li><a href="http://www.icu-project.org/userguide/charsetDetection.html"><b>Charset
<li><a href="http://userguide.icu-project.org/conversion/detection"><b>Charset
Detection</b></a> &#8211; Recognition of various single and multibyte charsets<br>
&nbsp;&nbsp;&nbsp;&nbsp;Useful for recognizing untagged text data</li>
<li><a
href="http://www.icu-project.org/userguide/unicodeSet.html"><b>UnicodeSet</b></a>
href="http://userguide.icu-project.org/strings/unicodeset"><b>UnicodeSet</b></a>
&#8211; standard set operations optimized for sets of Unicode characters<br>
&nbsp;&nbsp;&nbsp;&nbsp;UnicodeSets can be built from string patterns
using any Unicode properties.</li>
<li><a href="http://www.icu-project.org/userguide/Transform.html"><b>Transforms</b></a>
<li><a href="http://userguide.icu-project.org/transforms"><b>Transforms</b></a>
&#8211; a flexible mechanism for Unicode text conversions<br>
&nbsp;&nbsp;&nbsp;&nbsp;Including Full/Halfwidth conversions,
Normalization, Case conversions, Hex
conversions, and transliterations between scripts (50+ pairs)</li>
<li><a
href="http://www.icu-project.org/userguide/normalization.html"><b>Unicode
href="http://userguide.icu-project.org/transforms/normalization"><b>Unicode
Normalization</b></a> &#8211; NFC, NFD, NFKD, NFKC<br>
&nbsp;&nbsp;&nbsp;&nbsp;For canonical text representations, needed for
XML and the net</li>
<li><a
href="http://www.icu-project.org/userguide/dateCalendar.html"><b>International
href="http://userguide.icu-project.org/datetime/calendar"><b>International
Calendars</b></a> &#8211; Arabic, Buddhist, Chinese, Hebrew, Japanese, Ethiopic, Islamic, Coptic and other calendars<br>
&nbsp;&nbsp;&nbsp;&nbsp;Required for correct presentation of dates in
certain countries</li>
<li><a
href="http://www.icu-project.org/userguide/formatNumbers.html"><b>Date
href="http://userguide.icu-project.org/formatparse/datetime"><b>Date
Format
Enhancements</b></a> &#8211; Date/time pattern generator, Relative date formatting, etc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;Enhancements to the normal Java date
formatting.</li>
<li><a
href="http://www.icu-project.org/userguide/formatNumbers.html"><b>Number
href="http://userguide.icu-project.org/formatparse/numbers"><b>Number
Format
Enhancements</b></a> &#8211; Scientific Notation, Spelled-out, Compact decimal format, etc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;Enhancements to the normal Java number
formatting. The spell-out format is
used for checks and similar documents</li>
<li><a
href="http://www.icu-project.org/userguide/boundaryAnalysis.html"><b>Enhanced
href="http://userguide.icu-project.org/boundaryanalysis"><b>Enhanced
Word-Break Detection</b></a> &#8211; Rule-based, supports Thai, Khmer, Chinese, etc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;Required for correct support of Thai</li>
<li><a
href="http://www.icu-project.org/userguide/compression.html"><b>Unicode
href="http://userguide.icu-project.org/conversion/compression"><b>Unicode
Text
Compression</b></a> &#8211; Standard compression of Unicode text<br>
&nbsp;&nbsp;&nbsp;&nbsp;Suitable for large numbers of small fields,
where LZW and similar schemes
do not apply</li>
<li><a
href="http://www.icu-project.org/userguide/conversion.html"><b>Charset Conversion</b></a> &#8211; Conversion to and from different charsets.<br>
href="http://userguide.icu-project.org/conversion"><b>Charset Conversion</b></a> &#8211; Conversion to and from different charsets.<br>
&nbsp;&nbsp;&nbsp;&nbsp;Plugs into Java CharsetProvider Service Provider Interface (SPI)</li>

</ul>
Expand All @@ -143,10 +143,7 @@ <h2 class="doc"><a name="introduction"></a>Introduction to ICU4J</h2>

<h2 class="doc"><a name="changes"></a>Changes In This Release</h2>

<p>This release updates to Unicode 13 beta, CLDR 36.1, and includes some bug fixes.
This is a low-impact release with no other significant feature additions or implementation changes.</p>

<p>See the <a href="http://site.icu-project.org/download/66">ICU 66 download page</a>
<p>See the <a href="http://site.icu-project.org/download/67">ICU 67 download page</a>
for more informantion about changes in this release.</p>
<p>The list of API changes since the previous ICU4J release is available
<a href="APIChangeReport.html">here</a>.</p>
Expand All @@ -163,11 +160,11 @@ <h2 class="doc"><a name="license"></a>License Information</h2>
</p>
<h2 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h2>
<p>
The minimum Java runtime version supported by ICU4J 66 is version 7. Java runtime version 6 is not supported.
The minimum Java runtime version supported by ICU4J 67 is version 7. Java runtime version 6 is not supported.
</p>
<p>
ICU4J since version 63 depend on J2SE 7 functionality. Therefore, ICU4J only runs on
JRE version 7 or later. ICU4J 66 is tested on JRE 7, 8, 9, 10 and 11.
JRE version 7 or later. ICU4J 67 is tested on JRE 7, 8, 9, 10 and 11.
</p>

<h2 class="doc"><a name="download"></a>How to Download ICU4J</h2>
Expand All @@ -186,19 +183,19 @@ <h2 class="doc"><a name="download"></a>How to Download ICU4J</h2>
&lt;dependency&gt;
&lt;groupId&gt;com.ibm.icu&lt;/groupId&gt;
&lt;artifactId&gt;icu4j&lt;/artifactId&gt;
&lt;version&gt;66.1&lt;/version&gt;
&lt;version&gt;67.1&lt;/version&gt;
&lt;/dependency&gt;

&lt;dependency&gt;
&lt;groupId&gt;com.ibm.icu&lt;/groupId&gt;
&lt;artifactId&gt;icu4j-charset&lt;/artifactId&gt;
&lt;version&gt;66.1&lt;/version&gt;
&lt;version&gt;67.1&lt;/version&gt;
&lt;/dependency&gt;

&lt;dependency&gt;
&lt;groupId&gt;com.ibm.icu&lt;/groupId&gt;
&lt;artifactId&gt;icu4j-localespi&lt;/artifactId&gt;
&lt;version&gt;66.1&lt;/version&gt;
&lt;version&gt;67.1&lt;/version&gt;
&lt;/dependency&gt;
</pre>
</ul>
Expand Down Expand Up @@ -443,7 +440,7 @@ <h2 class="doc"><a name="WhatContain"></a>The Structure and Contents of
</table>

<h2 class="doc"><a name="API"></a>Where to get Documentation</h2>
<p>The <a href="http://www.icu-project.org/userguide/">ICU user's
<p>The <a href="http://userguide.icu-project.org/">ICU user's
guide</a> contains lots of general information about ICU, in its C,
C++, and Java incarnations.</p>
<p>The complete API documentation for ICU4J (javadoc) is available on
Expand Down Expand Up @@ -691,7 +688,7 @@ <h2 class="doc"><a name="HowToInstallJavac"></a>How to Install and Build</h2>
to the appropriate java options.</p>

<p><b>Eclipse users:</b> See the ICU4J site for information on<a
href="http://www.icu-project.org/docs/eclipse_howto/eclipse_howto.html">
href="http://site.icu-project.org/setup/eclipse">
how to configure Eclipse</a> to build and develop ICU4J on Eclipse IDE.</p>

<p><b>Note:</b> To install and configure ICU4J Locale Service Provider, please refer the user guide
Expand Down Expand Up @@ -733,54 +730,54 @@ <h2 class="doc"><a name="resources">ICU4J Resource Information</a></h2>
organization
of the data in ICU4J.</p>
<ul>
<li>The primary <b>locale data</b> is under the directory <tt>icudt66b</tt>,
<li>The primary <b>locale data</b> is under the directory <tt>icudt67b</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>break iterator data</b> is under the directory <tt>icudt66b/brkitr</tt>,
<li>The <b>break iterator data</b> is under the directory <tt>icudt67b/brkitr</tt>,
as a set of <tt>".res"</tt>, <tt>".brk"</tt> and <tt>".dict"</tt> files.</li>

<li>The <b>collation data</b> is under the directory <tt>icudt66b/coll</tt>,
<li>The <b>collation data</b> is under the directory <tt>icudt67b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>

<li>The <b>currency display name data</b> is under the directory <tt>icudt66b/curr</tt>,
<li>The <b>currency display name data</b> is under the directory <tt>icudt67b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>

<li>The <b>language display name data</b> is under the directory <tt>icudt66b/lang</tt>,
<li>The <b>language display name data</b> is under the directory <tt>icudt67b/lang</tt>,
as a set of <tt>".res"</tt> files.</li>

<li>The <b>rule-based number format data</b> is under the directory
<tt>icudt66b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<tt>icudt67b/rbnf</tt>, as a set of <tt>".res"</tt> files.

<li>The <b>region display name data</b> is under the directory <tt>icudt66b/region</tt>,
<li>The <b>region display name data</b> is under the directory <tt>icudt67b/region</tt>,
as a set of <tt>".res"</tt> files.</li>

<li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt66b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt67b/translit</tt>, as a set of <tt>".res"</tt> files.</li>

<li>The <b>measurement unit data</b> is under the directory <tt>icudt66b/unit</tt>,
<li>The <b>measurement unit data</b> is under the directory <tt>icudt67b/unit</tt>,
as a set of <tt>".res"</tt> files.</li>

<li>The <b>time zone display name data</b> is under the directory
<tt>icudt66b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt67b/zone</tt>, as a set of <tt>".res"</tt> files.</li>

<li>The <b>character property data</b> and default <b>unicode collation algorithm
(UCA) data</b> is found under the directory <tt>icudt66b</tt>, as a set of
(UCA) data</b> is found under the directory <tt>icudt67b</tt>, as a set of
<tt>".icu"</tt> files. </li>

<li>The <b>normalization data</b> is found under the directory <tt>icudt66b</tt>,
<li>The <b>normalization data</b> is found under the directory <tt>icudt67b</tt>,
as a set of <tt>".nrm"</tt> files. </li>

<li>The <b>character set converter data</b> is under the directory
<tt>icudt66b</tt>, as a set of <tt>".cnv"</tt> files. These files are
<tt>icudt67b</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>icudt66b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<tt>icudt67b</tt>, as <tt>zoneinfo64.res</tt>.</li>

<li>The <b>holiday data</b> is under the directory <tt>icudt66b</tt>,
<li>The <b>holiday data</b> is under the directory <tt>icudt67b</tt>,
as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
followed by the locale ID.</li>

Expand Down Expand Up @@ -878,8 +875,8 @@ <h3 class="doc"><a name="resourcesICU4C">Building ICU4J Resources from ICU4C</a>
<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-36'</li>
<li>Checkout ICU with tag 'release-66-1'</li>
<li>Checkout or download CLDR version 'release-37'</li>
<li>Checkout ICU with tag 'release-67-1'</li>
<li>cd to icu4c/source/data directory</li>
<li>Follow the instructions in icu4c/source/data/cldr-icu-readme.txt</li>
<li>Rebuild ICU4C with the newly generated data.</li>
Expand Down

0 comments on commit 4807a89

Please sign in to comment.