organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-14 09:21:03 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 1

ICU-0 update information about changes

Browse source 
X-SVN-Rev: 15811
This commit is contained in:
Doug Felt 2004-06-09 17:55:27 +00:00
parent a2af700b96
commit 5e51fdb55e
1 changed files with 45 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
icu4j/readme.html
View file

@ -165,13 +165,25 @@ current and complete version of this support is always found in ICU4J.
<ul>
<li><a href="#News_JDK1_3_Unsupported">JDK 1.3 no longer supported</a>
<li><a href="#News_ULocale">RFC 3066 initial implementation</a> (<tt>ULocale</tt> and <tt>UResourceBundle</tt> classes)
<li><a href="#News_JDK15_SupplementaryAPI">Added APIs for supplementary support to match JDK 1.5</a>
<li><a href="#News_TimeZone_IDs">TimeZone Identifiers</a>
<li><a href="#News_ULocale">RFC 3066 initial implementation</a> (<tt>ULocale</tt> class)
<li><a href="#News_Resource_Binary">Resource bundle implementation now uses ICU4C binary files</a>
</ul>
<p>A complete description of the API changes between version 3.0 and version 2.8 of ICU4J
can be found <a href="APIChangeReport.html">here</a>.</p>
<p>A complete report of the API changes between version 3.0 and
version 2.8 of ICU4J can be found <a
href="APIChangeReport.html">here</a>. This report is generated by a
tool and has some limitations, the most notable of which is that it
does not properly reflect the effect of class inheritance changes. For
example, ICU4J 3.0 moved the definition of some constants out of
some classes into interfaces that the classes now inherit, and
although this has no impact on the API available to the classes, the
tool reports this as a removal of API from them. Also of course,
being generated by a tool, the report does not provide explanation or
commentary on the changes. For background information and
clarification of changes it's always recommended that you check the
mailing list and archives.</p>
<h4><a name="News_JDK1_3_Unsupported" id="News_JDK1_3_Unsupported">JDK 1.3 No Longer Supported</a></h4>
@ -181,6 +193,31 @@ pains have become too great. ICU4J now requires a JDK 1.4 or later JVM both
to build and run. ICU4J is no longer tested on 1.3 or earlier JVMs. We apologize for
any inconvenience this may cause our users.</p>
<h4><a name="News_ULocale" id="News_ULocale">RFC 3066 Initial Implementation</a></h4>
<p>RFC 3066 defines a new format for Locale identifiers that
incorporates information about the script as well as the language and
region into the locale identifier. ICU4J has enhanced the
<tt>ULocale</tt> class to provide this information. ICU4J has also added
the <tt>UResourceBundle</tt> class to allow instantiation of resource
bundles using RFC 3066-style locale ids. This is an
initial implementation; not all ICU4J APIs that currently work with
<tt>Locale</tt> have been enhanced to work with <tt>ULocale</tt>. We
anticipate a complete implementation in the next ICU4J release.</p>
<h4><a name="News_JDK15_SupplementaryAPI" id="News_JDK15_SupplementaryAPI">
Added APIs for supplementary support to match JDK 1.5</a></h4>
<p>JDK 1.5 introduces new APIs for surrogate support. ICU4J has
offered surrogate support for several releases, and continues to offer
this functionality. However, to simplify porting between ICU4J and
JDK 1.5, where possible ICU4J has added APIs that provide the same
signature and semantics as those planned for 1.5. (There are some
unavoidable differences, for example, APIs added to java.lang.String
cannot be exactly matched by ICU4J). Members of the ICU team
participated in the JSR 204 expert group discussions and helped
develop the new Java APIs for supplementary character support.</p>
<h4><a name="News_TimeZone_IDs" id="News_TimeZone_IDs">TimeZone
Identifiers</a></h4>
@ -282,23 +319,17 @@ any inconvenience this may cause our users.</p>
SST (Pacific/Guadalcanal), VST (Asia/Saigon).
</font></p>
<h4><a name="News_ULocale" id="News_ULocale">RFC 3066 Initial Implementation</a></h4>
<p>RFC 3066 defines a new format for Locale identifiers that
incorporates information about the script as well as the language and
region into the locale identifier. ICU4J has enhanced the
<tt>ULocale</tt> class to provide this information. This is an
initial implementation; not all ICU4J APIs that currently work with
<tt>Locale</tt> have been enhanced to work with <tt>ULocale</tt>. We
anticipate a complete implementation in the next ICU4J release.</p>
<h4><a name="News_Resource_Binary" id="News_Resource_Binary">Resource
files now use ICU4C binary files</a></h4>
<p>ICU4J has switched to a new resource bundle implementation in order to utilize
the same binary data files used by ICU. This will likely impact clients who
have extended or modified the resource data provided in ICU4J. Most clients will
see no change from this switchover.</p>
see no change from this switchover. This change was made for several reasons,
the main ones being the desire to provide RFC 3066 support in a manner identical
to ICU, to avoid reworking the conversion tools (genrb) each time we evolve ICU's
resource bundle structure, and to avoid certain size constraints imposed by
java's class file format.</p>
<h3 class="doc"><a name=license></a>License Information</h3>
<p>