]> granicus.if.org Git - icu/commitdiff
ICU-9233 Updated ICU4J readme for 50m1
authorYoshito Umaoka <y.umaoka@gmail.com>
Mon, 25 Jun 2012 16:47:42 +0000 (16:47 +0000)
committerYoshito Umaoka <y.umaoka@gmail.com>
Mon, 25 Jun 2012 16:47:42 +0000 (16:47 +0000)
X-SVN-Rev: 31987

icu4j/readme.html

index cff682aa23876394e1d9232189f290282cda95ac..fef3d01dcf57422e3b5f0047612ebf63bf18fe78 100644 (file)
@@ -13,12 +13,15 @@ h4.doc { text-decoration: underline }
 <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 49.1</h3>
-(Last Update: March 16, 2012)
+<h3>Read Me for ICU4J 50 Milestone 1</h3>
+(Last Update: June 25, 2012)
 <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.
+<p><b>Note:</b> This is a development milestone release of ICU4J 50.
+The contents of this document may not reflect the recent changes done
+for ICU 50 development. This milestone is intended for those wishing
+to get an early look at ICU 50 new features and API changes. It is not
+recommended for production use.
 </p>
 <p>For the most recent release, see the <a
  href="http://www.icu-project.org/download/"> ICU4J
@@ -125,32 +128,9 @@ found in ICU4J.</p>
 <h3 class="doc"><a name="changes"></a>Changes In This Release</h3>
 <h4>New features and changes</h4>
 <p>
-See the <a href="http://sites.google.com/site/icusite/download/49">ICU 49 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-49-1/APIChangeReport.html">here</a>.
-</p>
-
-<h4>New ICU release version numbering</h4>
-<p>
-Starting this release, ICU release version numbering policy has changed to use a single
-major version field(e.g. "49") as oppose to two fields (e.g. "4.8"). The second field stays 0
-during development (e.g. "49.0.1" for ICU 49 development milestone 1) and the first official
-release within a major version is 1 (e.g. "49.1"). For the details, please refer to <a
-href="http://userguide.icu-project.org/design#TOC-Version-Numbers-in-ICU">Version Numbers
-in ICU</a>.
-</p>
-
-<h4>Locale variant for ICU4J Locale Service Provider</h4>
-<p>
-ICU4J Locale Service Provider uses a special Locale variant value for overriding Java's
-Locale service support. In this release, the default value of the special variant was
-changed to "ICU4J" (previously, it was "ICU"). For example, with JDK Locale("en", "US", "ICU4J"),
-ICU service implementation is used instead of Java's stock implementation for Locale("en", "US").
-This change had made for BCP 47 conformance. The special variant value can be changed by
-editing a properties file included in the ICU4J Locale Service Provider jar file.
-Please see the user guide page <a href="http://userguide.icu-project.org/icu4j-locale-service-provider">
-ICU4J Locale Service Provider</a> for the details.
+See the <a href="http://sites.google.com/site/icusite/download/50milestone">ICU 50 milestone 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/milestone-50-0-1/APIChangeReport.html">here</a>.
 </p>
 
 <h3 class="doc"><a name="license"></a>License Information</h3>
@@ -180,7 +160,7 @@ package.
 </p>
 <h3 class="doc"><a name="PlatformDependencies"></a>Platform Dependencies</h3>
 <p>
-ICU4J 49 depends on J2SE 5.0 functionality.  Therefore, ICU4J only runs on
+ICU4J 50 depends on J2SE 5.0 functionality.  Therefore, ICU4J only runs on
 JRE version 5.0 or later.
 The table below shows the operating systems and JRE/VM versions currently
 used by the ICU development team to test ICU4J.
@@ -845,54 +825,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>icudt49b</tt>,
+  <li>The primary <b>locale data</b> is under the directory <tt>icudt50b</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>collation data</b> is under the directory <tt>icudt49b/coll</tt>,
+  <li>The <b>collation data</b> is under the directory <tt>icudt50b/coll</tt>,
   as a set of <tt>".res"</tt> files.</li>
 
-  <li>The <b>currency display name data</b> is under the directory <tt>icudt49b/curr</tt>,
+  <li>The <b>currency display name data</b> is under the directory <tt>icudt50b/curr</tt>,
   as a set of <tt>".res"</tt> files.</li>
 
-  <li>The <b>language display name data</b> is under the directory <tt>icudt49b/lang</tt>,
+  <li>The <b>language display name data</b> is under the directory <tt>icudt50b/lang</tt>,
   as a set of <tt>".res"</tt> files.</li>
 
-  <li>The <b>region display name data</b> is under the directory <tt>icudt49b/region</tt>,
+  <li>The <b>region display name data</b> is under the directory <tt>icudt50b/region</tt>,
   as a set of <tt>".res"</tt> files.</li>
 
   <li>The <b>rule-based transliterator data</b> is under the directory
-  <tt>icudt49b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
+  <tt>icudt50b/translit</tt>, as a set of <tt>".res"</tt> files.</li>
 
   <li>The <b>rule-based number format data</b> is under the directory
-  <tt>icudt49b/rbnf</tt>, as a set of <tt>".res"</tt> files.
+  <tt>icudt50b/rbnf</tt>, as a set of <tt>".res"</tt> files.
 
   <li>The <b>break iterator data</b> is directly under the
-  directory <tt>icudt49b</tt>, as a set of <tt>".brk"</tt> files, named according to the
+  directory <tt>icudt50b</tt>, as a set of <tt>".brk"</tt> files, named according to the
   type of break and the locale where there are locale-specific versions.</li>
 
-  <li>The <b>holiday data</b> is under the directory <tt>icudt49b</tt>,
+  <li>The <b>holiday data</b> is under the directory <tt>icudt50b</tt>,
   as a set of <tt>".class"</tt> files, named <tt>"HolidayBundle_"</tt>
   followed by the locale ID.</li>
 
   <li>The <b>character property data</b> and default <b>unicode collation algorithm
-  (UCA) data</b> is found under the directory <tt>icudt49b</tt>, as a set of
+  (UCA) data</b> is found under the directory <tt>icudt50b</tt>, as a set of
   <tt>".icu"</tt> files. </li>
 
-  <li>The <b>normalization data</b> is found under the directory <tt>icudt49b</tt>,
+  <li>The <b>normalization data</b> is found under the directory <tt>icudt50b</tt>,
   as a set of <tt>".nrm"</tt> files. </li>
 
   <li>The <b>character set converter data</b> is under the directory
-  <tt>icudt49b</tt>, as a set of <tt>".cnv"</tt> files.  These files are
+  <tt>icudt50b</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>icudt49b</tt>, as <tt>zoneinfo64.res</tt>.</li>
+  <tt>icudt50b</tt>, as <tt>zoneinfo64.res</tt>.</li>
 
   <li>The <b>time zone display name data</b> is under the directory
-  <tt>icudt49b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
+  <tt>icudt50b/zone</tt>, as a set of <tt>".res"</tt> files.</li>
 </ul>
 <p>
 Some of the data files alias or otherwise reference data from other
@@ -988,8 +968,8 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
 <I> Note: This procedure assumes that all 3 sources are present</I>
 <ol>
     <li>Checkout or download CLDR version 'release-21-0-1'</li>
-    <li>Checkout ICU4C with tag 'release-49-1'</li>
-    <li>Checkout ICU4J with tag 'release-49-1'</li>
+    <li>Checkout ICU4C with tag 'milestone-50-0-1'</li>
+    <li>Checkout ICU4J with tag 'milestone-50-0-1'</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>
@@ -1001,7 +981,7 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in <I>$icu4c_r
 </ol>
 
 <h3 class="doc"><a name="timezone"></a>About ICU4J Time Zone</h3>
-<p>ICU4J 49.1 includes time zone data version 2012b, which is the latest one as of
+<p>ICU4J 50M1 includes time zone data version 2012c, 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