mirror of
https://github.com/unicode-org/icu.git
synced 2025-04-06 14:05:32 +00:00
ICU-20979 BRS67RC Updating ICU4J readme
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.
This commit is contained in:
Yoshito Umaoka
parent
d0f2aa6c58
commit
4807a89297
1 changed files with 45 additions and 48 deletions
|
|
@ -14,23 +14,23 @@ h3.doc { text-decoration: underline }
|
|||
<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
|
||||
|
|
@ -76,60 +76,60 @@ internationalization API design.</p>
|
|||
</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>
|
||||
– rule-based, up-to-date Unicode Collation Algorithm (UCA) sorting order<br>
|
||||
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> – Recognition of various single and multibyte charsets<br>
|
||||
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>
|
||||
– standard set operations optimized for sets of Unicode characters<br>
|
||||
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>
|
||||
– a flexible mechanism for Unicode text conversions<br>
|
||||
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> – NFC, NFD, NFKD, NFKC<br>
|
||||
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> – Arabic, Buddhist, Chinese, Hebrew, Japanese, Ethiopic, Islamic, Coptic and other calendars<br>
|
||||
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> – Date/time pattern generator, Relative date formatting, etc.<br>
|
||||
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> – Scientific Notation, Spelled-out, Compact decimal format, etc.<br>
|
||||
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> – Rule-based, supports Thai, Khmer, Chinese, etc.<br>
|
||||
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> – Standard compression of Unicode text<br>
|
||||
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> – Conversion to and from different charsets.<br>
|
||||
href="http://userguide.icu-project.org/conversion"><b>Charset Conversion</b></a> – Conversion to and from different charsets.<br>
|
||||
Plugs into Java CharsetProvider Service Provider Interface (SPI)</li>
|
||||
|
||||
</ul>
|
||||
|
|
@ -143,10 +143,7 @@ found in ICU4J.</p>
|
|||
|
||||
<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>
|
||||
|
|
@ -163,11 +160,11 @@ file included in this package.
|
|||
</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>
|
||||
|
|
@ -186,19 +183,19 @@ builds, and they are packaged in jar files for convenient download.
|
|||
<dependency>
|
||||
<groupId>com.ibm.icu</groupId>
|
||||
<artifactId>icu4j</artifactId>
|
||||
<version>66.1</version>
|
||||
<version>67.1</version>
|
||||
</dependency>
|
||||
|
||||
<dependency>
|
||||
<groupId>com.ibm.icu</groupId>
|
||||
<artifactId>icu4j-charset</artifactId>
|
||||
<version>66.1</version>
|
||||
<version>67.1</version>
|
||||
</dependency>
|
||||
|
||||
<dependency>
|
||||
<groupId>com.ibm.icu</groupId>
|
||||
<artifactId>icu4j-localespi</artifactId>
|
||||
<version>66.1</version>
|
||||
<version>67.1</version>
|
||||
</dependency>
|
||||
</pre>
|
||||
</ul>
|
||||
|
|
@ -443,7 +440,7 @@ ICU4J source archive is extracted.
|
|||
</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
|
||||
|
|
@ -691,7 +688,7 @@ you can set the heap size of the jvm by setting the environment variable JVM_OPT
|
|||
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
|
||||
|
|
@ -733,54 +730,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>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>
|
||||
|
||||
|
|
@ -878,8 +875,8 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in icu4c/sourc
|
|||
<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>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue