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

ICU-12456 Updated readme.html, including version strings, license section, supported Java version and some others.

Browse Source 
X-SVN-Rev: 38918
This commit is contained in:
Yoshito Umaoka 2016-07-01 17:12:44 +00:00
parent ad1cf1e346
commit c177e7e8e5
1 changed files with 48 additions and 102 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

150
icu4j/readme.html
View File

@ -5,8 +5,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Style-Type" content="text/css2">
<title>ReadMe for ICU4J</title>
<meta name="COPYRIGHT" content"© 2016 and later: Unicode, Inc. and others. License & terms of use: http://www.unicode.org/copyright.html#License">
<!-- meta name="COPYRIGHT" content="Copyright 2000-2016, International Business Machines Corporation and others. All Rights Reserved." -->
<meta name="COPYRIGHT" content="© 2016 and later: Unicode, Inc. and others. License & terms of use: http://www.unicode.org/copyright.html#License">
<style type="text/css">
h3.doc { background: #CCCCFF }
h4.doc { text-decoration: underline }
@ -15,29 +14,24 @@ h4.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 57 Release Candidate</h2>
(Last Update: 2016-March-4)
<h2>Read Me for ICU4J 58 Milestone 1</h2>
(Last Update: 2016-July-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 development release of ICU4J 57.
<b>Note:</b> This is a development release of ICU4J 58.
The contents of this document may not reflect the recent changes done
for ICU 57 development. This milestone is intended for those wishing
to get an early look at ICU4J 57 new features and API changes. It is not
for ICU 58 development. This milestone is intended for those wishing
to get an early look at ICU4J 58 new features and API changes. It is not
recommended for production use.
<!-- <b>Note:</b> This is a release candidate of ICU4J 58.
The contents of this document may not reflect the recent changes done
for ICU 58 development. This release candidate is intended for those
wishing to verify ICU 58 integration before final release. It is not
recommended for production use. -->
<b>Note:</b> This is a release candidate of ICU4J 57.
The contents of this document may not reflect the recent changes done
for ICU 57 development. This release candidate is intended for those
wishing to verify ICU 57 integration before final release. It is not
recommended for production use.
<!-- <b>Note:</b> This is a development release of ICU4J 57.
The contents of this document may not reflect the recent changes done
for ICU 57 development. This milestone is intended for those
wishing to verify ICU 57 integration before final release. It is not
recommended for production use.
</p> -->
</p>
<p>For the most recent release, see the <a
href="http://www.icu-project.org/download/"> ICU4J
download site</a>. </p>
@ -142,45 +136,30 @@ found in ICU4J.</p>
<h2 class="doc"><a name="changes"></a>Changes In This Release</h2>
<p>See the <a href="https://sites.google.com/site/icusite/download/57">ICU 57 download page</a>
<p>See the <a href="https://sites.google.com/site/icusite/download/58">ICU 58 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-57-rc/APIChangeReport.html">here</a>.</p>
<a href="http://source.icu-project.org/repos/icu/icu4j/tags/milestone-58-0-1/APIChangeReport.html">here</a>.</p>
<!-- ICU 57 items -->
<!-- ICU 58 items -->
<!-- <h3>[Subject]</h3> -->
<!-- end ICU 57 items -->
<!-- end ICU 58 items -->
<h2 class="doc"><a name="license"></a>License Information</h2>
<p>
The ICU projects (ICU4C and ICU4J) use the X license. The X
license is <b>suitable for commercial use</b> and is a recommended free software license
that is compatible with the GNU GPL license. This became
effective with release 1.8.1 of ICU4C and release 1.3.1 of ICU4J in
mid-2001. All new ICU releases will adopt the X license; previous ICU
releases continue to utilize the IPL (IBM Public License). Users
of previous releases of ICU who want to adopt new ICU releases will
need to accept the terms and conditions of the X license.
</p>
<p>
The main effect of the change is to provide GPL compatibility.
The X license is listed as GPL compatible, see the GNU page at
<a href="http://www.gnu.org/licenses/license-list.html#GPLCompatibleLicenses">
http://www.gnu.org/licenses/license-list.html#GPLCompatibleLicenses</a>.
This means that GPL projects can now use ICU code, it does <b>not</b>
mean that projects using ICU become subject to GPL.
</p>
<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">ICU's license</a> is included in the download
package.
The ICU projects (ICU4C and ICU4J) are hosted by the
<a href="http://www.unicode.org/">Unicode Consortium</a>. The ICU binary
and source files are distributed under the
<a href="http://www.unicode.org/copyright.html#License">UNICODE DATA FILES
AND SOFTWARE LICENSE</a>. The full copy of the license and third party
software licences are available in <a href="./main/shared/licenses/LICENSE">LICENSE</a>
file included in this package.
</p>
<h2 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h2>
<p>
ICU4J 57 depends on J2SE 5.0 functionality. Therefore, ICU4J only runs on
JRE version 5.0 or later.
ICU4J 58 depends on J2SE 6 functionality. Therefore, ICU4J only runs on
JRE version 6 or later.
The table below shows the operating systems and JRE/VM versions currently
used by the ICU development team to test ICU4J.
</p>
@ -190,7 +169,6 @@ used by the ICU development team to test ICU4J.
<th colspan="2">JRE 8</th>
<th colspan="2">JRE 7</th>
<th colspan="2">JRE 6</th>
<th colspan="2">JRE 5</th>
</tr>
<tr>
<th>32bit</th>
@ -199,8 +177,6 @@ used by the ICU development team to test ICU4J.
<th>64bit</th>
<th>32bit</th>
<th>64bit</th>
<th>32bit</th>
<th>64bit</th>
</tr>
<tr>
<th>AIX 6.1</th>
@ -210,8 +186,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>AIX 7.1</th>
@ -221,8 +195,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#CCCCFF"><em><b>Reference platform</b></em></td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>HP-UX 11 (IA64)</th>
@ -232,8 +204,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>Mac OS X 10.6</th>
@ -243,8 +213,6 @@ used by the ICU development team to test ICU4J.
<td align="center">-</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center">-</td>
</tr>
<tr>
<th>Redhat Enterprise Linux 6 (x86)</th>
@ -254,8 +222,6 @@ used by the ICU development team to test ICU4J.
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
</tr>
<tr>
<th>Redhat Enterprise Linux 6 (x86_64)</th>
@ -265,8 +231,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#CCCCFF"><em><b>Reference platform</b></em></td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>Solaris 10 (SPARC)</th>
@ -276,8 +240,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>Solaris 11 (SPARC)</th>
@ -287,8 +249,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
<tr>
<th>Windows XP</th>
@ -298,8 +258,6 @@ used by the ICU development team to test ICU4J.
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
</tr>
<tr>
<th>Windows Vista</th>
@ -309,8 +267,6 @@ used by the ICU development team to test ICU4J.
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
</tr>
<tr>
<th>Windows 7</th>
@ -320,8 +276,6 @@ used by the ICU development team to test ICU4J.
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
</tr>
<tr>
<th>Windows 2008 Server</th>
@ -331,8 +285,6 @@ used by the ICU development team to test ICU4J.
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
<td align="center">-</td>
<td align="center" bgcolor="#DDDDFF">Regularly tested</td>
</tr>
</table>
@ -651,9 +603,8 @@ on your Java CLASSPATH. If you need Charset API support please also place
<strong>icu4j-charset.jar</strong> on your class path along with <strong>icu4j.jar</strong>.
</p>
<p>
To build ICU4J, you will need J2SE SDK 5.0 or later (ICU4J locale SPI
provider sub-components require J2SE SDK 6.0 or later) and the Ant build system
version 1.7 or later. It's recommended to install both the J2SE SDK and Ant
To build ICU4J, you will need J2SE SDK 6 or later and the Ant build system
version 1.8 or later. It's recommended to install both the J2SE SDK and Ant
somewhere <em>outside</em>the ICU4J directory. For example, on Linux you might install
these in <code>/usr/local</code>.</p>
<ul>
@ -849,9 +800,6 @@ how to configure Eclipse</a> to build and develop ICU4J on Eclipse IDE.</p>
page <a href="http://userguide.icu-project.org/icu4j-locale-service-provider">ICU4J Locale
Service Provider</a>.</p>
<!-- <p><b>Note:</b> ICU4J 57 does not support JDK 8 javadoc tool yet. The build targets "doc" and
"docs" will fail when JDK 8 javadoc tool is used.</p> -->
<h2 class="doc"><a name="HowToModularize"></a>How to modularize ICU4J</h2>
<p>Some clients may not wish to ship all of ICU4J with their
application, since the application might only use a small part of ICU4J.
@ -895,54 +843,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>icudt57b</tt>,
<li>The primary <b>locale data</b> is under the directory <tt>icudt58b</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>icudt57b/brkitr</tt>,
<li>The <b>break iterator data</b> is under the directory <tt>icudt58b/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>icudt57b/coll</tt>,
<li>The <b>collation data</b> is under the directory <tt>icudt58b/coll</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>currency display name data</b> is under the directory <tt>icudt57b/curr</tt>,
<li>The <b>currency display name data</b> is under the directory <tt>icudt58b/curr</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>language display name data</b> is under the directory <tt>icudt57b/lang</tt>,
<li>The <b>language display name data</b> is under the directory <tt>icudt58b/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>icudt57b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<tt>icudt58b/rbnf</tt>, as a set of <tt>".res"</tt> files.
<li>The <b>region display name data</b> is under the directory <tt>icudt57b/region</tt>,
<li>The <b>region display name data</b> is under the directory <tt>icudt58b/region</tt>,
as a set of <tt>".res"</tt> files.</li>
<li>The <b>rule-based transliterator data</b> is under the directory
<tt>icudt57b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt58b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
<li>The <b>measurement unit data</b> is under the directory <tt>icudt57b/unit</tt>,
<li>The <b>measurement unit data</b> is under the directory <tt>icudt58b/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>icudt57b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
<tt>icudt58b/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>icudt57b</tt>, as a set of
(UCA) data</b> is found under the directory <tt>icudt58b</tt>, as a set of
<tt>".icu"</tt> files. </li>
<li>The <b>normalization data</b> is found under the directory <tt>icudt57b</tt>,
<li>The <b>normalization data</b> is found under the directory <tt>icudt58b</tt>,
as a set of <tt>".nrm"</tt> files. </li>
<li>The <b>character set converter data</b> is under the directory
<tt>icudt57b</tt>, as a set of <tt>".cnv"</tt> files. These files are
<tt>icudt58b</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>icudt57b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<tt>icudt58b</tt>, as <tt>zoneinfo64.res</tt>.</li>
<li>The <b>holiday data</b> is under the directory <tt>icudt57b</tt>,
<li>The <b>holiday data</b> is under the directory <tt>icudt58b</tt>,
as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
followed by the locale ID.</li>
@ -1040,9 +988,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-29'</li>
<li>Checkout ICU4C with tag 'release-57-rc'</li>
<li>Checkout ICU4J with tag 'release-57-rc'</li>
<li>Checkout or download CLDR version 'release-30'</li>
<li>Checkout ICU4C with tag 'release-58-rc'</li>
<li>Checkout ICU4J with tag 'release-58-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>
@ -1054,7 +1002,7 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
</ol>
<h2 class="doc"><a name="timezone"></a>About ICU4J Time Zone</h2>
<p>ICU4J 57 Release Candidate includes time zone data version 2016a, which is the latest one as of
<p>ICU4J 58 Milestone 1 includes time zone data version 2016e, 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
@ -1092,10 +1040,8 @@ review all comments.</p>
<h2>Thank you for your interest in ICU4J!</h2>
<br>
<hr align="center" size="2" width="100%">
<p><I><font size="-1">Copyright &copy; 2000-2016 International Business
Machines Corporation and others. All Rights
Reserved.<br>
4400 North First Street, San Jos&eacute;, CA 95193, USA
<p><I><font size="-1">© 2016 and later: Unicode, Inc. and others.<br>
License & terms of use: <a href="http://www.unicode.org/copyright.html#License">http://www.unicode.org/copyright.html#License</a>
</font></I></p>
</body>
</html>