organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-08 06:53:45 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 2

ICU-5067 update readme, change report for 3.4.3

Browse source 
X-SVN-Rev: 19252
This commit is contained in:
Doug Felt 2006-02-23 18:32:00 +00:00
parent a626ec07a7
commit 16fffdd6bf
2 changed files with 56 additions and 89 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

61
icu4j/APIChangeReport.html
View file

@ -2,72 +2,37 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>ICU4J API Comparison: ICU4J 3.4.1 with ICU4J 3.4.2</title>
<title>ICU4J API Comparison: ICU4J 3.4.2 with ICU4J 3.4.3</title>
<!-- Copyright 2006, IBM, All Rights Reserved. -->
</head>
<body>
<h1>ICU4J API Comparison: ICU4J 3.4.1 with ICU4J 3.4.2</h1>
<h1>ICU4J API Comparison: ICU4J 3.4.2 with ICU4J 3.4.3</h1>
<hr/>
<h2>Removed from ICU4J 3.4.1</h2>
<h3>Package com.ibm.icu.util</h3>
<ul>
UResourceBundle
<ul>
<li>(draft) protected static UResourceBundle <i>instantiateICUResource</i>(java.lang.String, java.lang.String, java.lang.ClassLoader)</li>
</ul>
</ul>
<h2>Removed from ICU4J 3.4.2</h2>
<p>(no API removed)</p>
<hr/>
<h2>Deprecated or Obsoleted in ICU4J 3.4.2</h2>
<h3>Package com.ibm.icu.text</h3>
<ul>
NumberFormat
<ul>
<li>(deprecated) protected static java.lang.String <i>getPattern</i>(java.util.Locale, int)</li>
</ul>
</ul>
<h2>Deprecated or Obsoleted in ICU4J 3.4.3</h2>
<p>(no API obsoleted)</p>
<hr/>
<h2>Changed in ICU4J 3.4.2 (old, new)</h2>
<h2>Changed in ICU4J 3.4.3 (old, new)</h2>
<p>(no API changed)</p>
<hr/>
<h2>Promoted to stable in ICU4J 3.4.2</h2>
<p>(no API promoted)</p>
<hr/>
<h2>Added in ICU4J 3.4.2</h2>
<h2>Promoted to stable in ICU4J 3.4.3</h2>
<h3>Package com.ibm.icu.text</h3>
<ul>
DecimalFormat
<ul>
<li>(draft) public void <i>setRoundingIncrement</i>(BigDecimal)</li>
</ul>
<li>(stable) public class <i>MessageFormat</i></li>
</ul>
<h3>Package com.ibm.icu.util</h3>
<ul>
SimpleTimeZone
<ul>
<li>(draft) public java.lang.Object <i>clone</i>()</li>
<li>(draft) public boolean <i>equals</i>(java.lang.Object)</li>
<li>(draft) public int <i>hashCode</i>()</li>
<li>(draft) public java.lang.String <i>toString</i>()</li>
</ul>
TimeZone
<ul>
<li>(draft) public boolean <i>equals</i>(java.lang.Object)</li>
<li>(draft) public int <i>hashCode</i>()</li>
</ul>
</ul>
<hr/>
<p><i><font size="-1">Contents generated by ReportAPI tool on Fri Jan 13 12:21:37 PST 2006<br/>Copyright (C) 2006, International Business Machines Corporation, All Rights Reserved.</font></i></p>
<h2>Added in ICU4J 3.4.3</h2>
<p>(no API added)</p>
<hr/>
<p><i><font size="-1">Contents generated by ReportAPI tool on Thu Feb 23 08:36:05 PST 2006<br/>Copyright (C) 2006, International Business Machines Corporation, All Rights Reserved.</font></i></p>
</body>
</html>

84
icu4j/readme.html
View file

@ -18,10 +18,10 @@ h3.doc { background: #CCCCFF }
<body style="background-color: rgb(255, 255, 255);" lang="EN-US"
link="#0000ff" vlink="#800080">
<h2>International Components for Unicode for Java (ICU4J)</h2>
<h3>Read Me for ICU4J 3.4.2</h3>
<h3>Read Me for ICU4J 3.4.3</h3>
<hr size="2" width="100%">
<p><b>Release Date</b><br>
Jan 16, 2006<br>
Feb 24, 2006<br>
</p>
<p><b>Note:</b> This is an update release of ICU4J 3.4. It contains bug fixes
and adds implementations of inherited API, but does not introduce new API
@ -195,12 +195,13 @@ current and complete version of this support is always found in ICU4J.
-->
<h3 class="doc"><a name="news"></a>What Is New In This Release?</h3>
<ul>
<li><a href="#News_Eclipse">Changes for Eclipse</a></li>
<li><a href="#News_Time_Zone">ICU Time Zone Data</a></li>
<li><a href="#News_Java13">Java 1.3 Support</a></li>
<li><a href="#News_Time_Zone">New Time Zone Data</a></li>
<li><a href="#News_deprecated">No Deprecated Warnings for Draft APIs</a></li>
<li><a href="#News_Fixes">Fixes</a></li>
</ul>
<p>A complete report of the API changes between version 3.4.2 and
version 3.4.1 of ICU4J can be found
<p>A complete report of the API changes between version 3.4.3 and
version 3.4.2 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
@ -208,31 +209,34 @@ changes. 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_Eclipse" id="News_Eclipse">Changes for Eclipse</a></h4>
<p>The primary driver for this release is to snapshot the version of ICU4J
that will be made available as an Eclipse jar. This required some changes
to ICU4J to meet Eclipse requirements, in particular, the ability to have
a version of ICU4J that builds and runs under a Foundation 1.0 profile.
This profile is a subset of JDK 1.3, and omits some functionality and API that
the standard version of ICU4J uses.</p>
<p>In order to accomodate this, we use an internal 'preprocessing' tool
to tweak standard ICU4J source files. A dozen or so ICU4J files were
marked up so that the tool could conditionally add or omit APIs and code
as required. The Eclipse version of the ICU4J APIs is therefore
somewhat different from the standard version, while the standard version has
not regressed from the previous release.</p>
<h4><a name="News_Time_Zone" id="News_Time_Zone">ICU Time Zone Data</a></h4>
<p>ICU4J now (once again) uses its own time zone data rather than relying
upon the time zone data in the JDK. This allows users to get current time
zone information even when running on older versions of the JDK.</p>
<h4><a name="News_Java13" id="News_Java13">Java 1.3 Support</a></h4>
<p>This release continues the progress made in 3.4.2 towards Java 1.3
support. It is now possible to both build and run a version of ICU4J on
Java 1.3. ICU4J still ships by default for running on Java 1.4, and
must be rebuilt to work on 1.3-- this is a simple matter of rebuilding
using the 'jdk13Compat' ant build target. Some APIs supported by ICU4J
do not exist in Java 1.3, and so the 1.3-compatible version removes
those APIs via a preprocessing step. Most of the APIs, though, are
the same in both versions.
<h4><a name="News_Time_Zone" id="News_Time_Zone">New Time Zone Data</a></h4>
<p>ICU4J 3.4.2 saw ICU4J once again use its own time zone data. Release 3.4.3
updates the time zone data to version 2006a from the Olson time
zone database. This supports recent time zone changes, including the upcoming
change to U.S. daylight saving time.</p>
<h4><a name="News_deprecated" id="News_deprecated">No Deprecated Warnings for
Draft APIs.</a></h4>
<p>ICU4J 3.4.3 now by default ships with @deprecated warnings for @draft APIs
turned off. This was proving to be more of a nuisance than a help to our
clients. A tool has been provided (swatdeprecated) which can be used to
reenable @deprecated warnings for @draft APIs.</p>
<h4><a name="News_Fixes" id="News_Fixes">Fixes:</a></h4>
<p>This release contains the following bug fixes (not a complete list):<ul>
</ul>
<li><b>jb4422:</b> RFE: ICU4J should not depend on <tt>sun.util.calendar.ZoneInfo</tt></li>
<li><b>jb4555:</b> Chinese calendar missing constructor call to <tt>setTimeInMillis()</tt></li>
<li><b>jb4767:</b> RFE: Provide mechanism for loading Java resources with <tt>ULocale</tt></li>
<li><b>jb4863:</b> possible rounding bug for currency (Locale=de_CH)</li>
<li><b>jb4904:</b> <tt>ChineseDateFormat.toLocalizedPattern()</tt> throws java.lang.IllegalArgumentException: Illegal pattern character 'l'</li>
<li><b>jb5006:</b> DateFormat would use the wrong short month names in some locales</li>
<li><b>jb5015:</b> Historical Daylight Saving Time calculation was off by an hour.</li>
<li><b>jb5038:</b> MessageFormat APIs that parallel Java's are now @stable, to facilitate migration to ICU4J.</li>
<li><b>jb5054:</b> SimpleDateFormat would sometimes throw an exception during construction</li>
<li><b>jb5061:</b> StringTokenizer did not match Java's StringTokenizer behavior when returning tokens for delimiters</li>
</ul>
<br/>
</p>
@ -264,13 +268,11 @@ X-specific trademarks and copyright notices. The full copy of <a
package.
</p>
<h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
<p> Parts of ICU4J depend on functionality that is only available in
JDK 1.4 or later, although some components work under earlier JVMs. All
components should be compiled using a Java 2 compiler, as even
components that run under earlier JVMs can require language features
that are only present in Java2. Currently 1.1.x, 1.2.x and 1.3.x JVMs
are unsupported and untested, and you use the components on these JVMs
at your own risk.</p>
<p> By default ICU4J depends on functionality that is only available
in JDK 1.4. We provide the ability to build a variant of ICU4J
that will run on JDK 1.3, but not all build targets work on that
platform. Currently 1.1.x and 1.2.x JVMs are unsupported and untested,
and you use the components on these JVMs at your own risk.</p>
<p> The reference platforms which we support and test ICU4J on are:</p>
<ul>
<li> WinXP, IBM JDK 1.4.2</li>
@ -279,15 +281,15 @@ at your own risk.</p>
</ul>
<p>Please use the most recent updates of the supported JDK versions.</p>
<p>Additionally, we have built and tested ICU4J on the following <b>unsupported</b>
platforms:
platforms (note, only some build/test targets work on 1.3 platforms):
</p>
<ul>
<li> Win2K / IBM JDK 1.4.1, Sun JDK 1.4, 1.4.1, 1.4.2</li>
<li> WinXP / IBM JDK 1.4.1, Sun JDK 1.4.2, 1.5.0</li>
<li> WinXP / IBM JDK 1.3.1, 1.4.1, Sun JDK 1.3.1, 1.4.2, 1.5.0</li>
<li> Solaris 5.6 , Solaris 5.7 / Sun JDK 1.4, 1.4.1, 1.4.2</li>
<li> Solaris 5.9 / Sun JDK 1.4, 1.4.1, 1.4.2</li>
<li> Solaris 5.9 / Sun JDK 1.3.1, 1.4, 1.4.1, 1.4.2</li>
<li> AIX 5.1, AIX 5.2 / IBM JDK 1.4.1</li>
<li> RedHat Enterprise Linux 3/ IBM JDK 1.4.1, 1.4.0, Sun JDK 1.4, 1.4.1, 1.4.2, 1.5.0</li>
<li> RedHat Enterprise Linux 3/ IBM JDK 1.4.1, 1.4.0, Sun JDK 1.3.1, 1.4, 1.4.1, 1.4.2, 1.5.0</li>
<li> RedHat Linux 7.2/ IBM JDK 1.4.1, 1.4.0, Sun JDK 1.4, 1.4.1, 1.4.2, 1.5.0</li>
</ul>
<h3 class="doc"><a name="obtaining"></a>How to Download ICU4J</h3>
@ -717,7 +719,7 @@ listed.
fully supported.
<br>
&#8225; Sizes are of the compressed jar file containing only this module.
Full size is 3,047&nbsp;KB.
These sizes are approximate for release 3.4.3.
</font></b>
<p><b>Modules:</b></p>
<table bgcolor="#ccccff" cellpadding="3" frame="void" width="623">
@ -1359,7 +1361,7 @@ 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; 2002-2005 International Business
<p><i><font size="-1">Copyright &copy; 2002-2006 International Business
Machines Corporation and others. All Rights
Reserved.<br>
5600 Cottle Road, San Jos&eacute;, CA 95193