From dd4063d9f4bc131adfc48247200b171cb7670d5a Mon Sep 17 00:00:00 2001 From: Yoshito Umaoka Date: Fri, 16 Mar 2012 06:59:46 +0000 Subject: [PATCH] ICU-9187 Updated readme.html for the official release (49.1). X-SVN-Rev: 31623 --- icu4j/readme.html | 87 ++++++++++++++++++++++++++--------------------- 1 file changed, 49 insertions(+), 38 deletions(-) diff --git a/icu4j/readme.html b/icu4j/readme.html index f32b04f2514..cff682aa238 100644 --- a/icu4j/readme.html +++ b/icu4j/readme.html @@ -13,15 +13,12 @@ h4.doc { text-decoration: underline }

International Components for Unicode for Java (ICU4J)

Read Me for ICU4J 49 RC

-(Last Update: March 2, 2012) +

Read Me for ICU4J 49.1

+(Last Update: March 16, 2012)

Note: This is a release candidate of ICU4J 49. -The contents of this document may not reflect the recent changes done -for ICU 49 development. This version is inteneded for those wishing -to evaluate ICU 49 new features and API changes. It is not -recommended for production use. +

Note: This is major release of ICU4J. It contains bug fixes and adds implementations +of inherited API and introduces new API or functionality.

For the most recent release, see the ICU4J @@ -128,11 +125,34 @@ found in ICU4J.

Changes In This Release

New features and changes

-See the ICU 49 RC download page about +See the ICU 49 download page about new features in this release. The list of API changes since the previous ICU4J release is available -here. +here.

+ +

New ICU release version numbering

+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 Version Numbers +in ICU. +

+ +

Locale variant for ICU4J Locale Service Provider

+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 +ICU4J Locale Service Provider for the details. +

License Information

The ICU projects (ICU4C and ICU4J) use the X license. The X @@ -602,7 +622,7 @@ version 1.7 or later. It's recommended to install both the J2SE SDK and Ant somewhere outsidethe ICU4J directory. For example, on Linux you might install these in /usr/local.

Install J2SE SDK 6.0.
Install J2SE SDK 7.

Install the Ant build system. Ant is a portable, Java-based build system similar to make. ICU4J uses Ant because it introduces no other dependencies, it's @@ -614,7 +634,7 @@ these in /usr/local.

extract it onto your system, set some environment variables, and add its bin directory to your path. For example:

-        set JAVA_HOME=C:\jdk1.6.0
+        set JAVA_HOME=C:\jdk1.7.0
         set ANT_HOME=C:\ant
         set PATH=%PATH%;%ANT_HOME%\bin

See the current Ant documentation for details.

@@ -628,19 +648,16 @@ root directory. You can give Ant options like -verbose, and you can specify other targets. For example:

C:\icu4j>ant
-Buildfile: build.xml
-
 Buildfile: C:\icu4j\build.xml
 
 info:
      [echo] ----- Build Environment Information -------------------
-     [echo] Java Home:    C:\jdk1.6.0
-     [echo] Java Version: 1.6.0
+     [echo] Java Home:    C:\jdk1.7.0
+     [echo] Java Version: 1.7.0
      [echo] Ant Home:     C:\ant
-     [echo] Ant Version:  Apache Ant(TM) version 1.8.2 compiled on December 20 2
-010
+     [echo] Ant Version:  Apache Ant(TM) version 1.8.3 compiled on February 26 2012
      [echo] OS:           Windows 7
-     [echo] OS Version:   6.1 build 7601 Service Pack 1
+     [echo] OS Version:   6.1
      [echo] OS Arch:      x86
      [echo] Host:         ICUDEV
      [echo] -------------------------------------------------------
@@ -651,15 +668,15 @@ core:
      [echo] --- java compiler arguments ------------------------
      [echo] source dir:     C:\icu4j\main\classes\core/src
      [echo] output dir:     C:\icu4j\main\classes\core/out/bin
-     [echo] classpath:
+     [echo] classpath:      
      [echo] source:         1.5
      [echo] target:         1.5
      [echo] debug:          on
      [echo] encoding:       UTF-8
-     [echo] compiler arg:   -Xlint:all,-deprecation,-dep-ann
+     [echo] compiler arg:   -Xlint:all,-deprecation,-dep-ann,-options
      [echo] ----------------------------------------------------
     [mkdir] Created dir: C:\icu4j\main\classes\core\out\bin
-    [javac] Compiling 331 source files to C:\icu4j\main\classes\core\out\bin
+    [javac] Compiling 336 source files to C:\icu4j\main\classes\core\out\bin
     [javac] Note: Some input files use or override a deprecated API.
     [javac] Note: Recompile with -Xlint:deprecation for details.
 
@@ -669,33 +686,29 @@ compile:
      [copy] Copying 23 files to C:\icu4j\main\classes\core\out\bin
 
 copy-data:
-    [unjar] Expanding: C:\icu4j\main\shared\data\icudata.jar into C:\icu4j\main\
-classes\core\out\bin
+    [unjar] Expanding: C:\icu4j\main\shared\data\icudata.jar into C:\icu4j\main\classes\core\out\bin
+    [unjar] Expanding: C:\icu4j\main\shared\data\icutzdata.jar into C:\icu4j\main\classes\core\out\bin
 
 ...
 ...
 ...
 
-build:
-
 _build-localespi:
 
 @compile:
      [echo] --- java compiler arguments ------------------------
      [echo] source dir:     C:\icu4j\main\classes\localespi/src
      [echo] output dir:     C:\icu4j\main\classes\localespi/out/bin
-     [echo] classpath:      C:\icu4j\main\classes\core\out\lib\icu4j-core.jar;C:
-\icu4j\main\classes\collate\out\lib\icu4j-collate.jar
+     [echo] classpath:      C:\icu4j\main\classes\core\out\lib\icu4j-core.jar;C:\icu4j\main\classes\collate\out\lib\icu4j-collate.jar
      [echo] source:         1.6
      [echo] target:         1.6
      [echo] debug:          on
      [echo] encoding:       UTF-8
-     [echo] compiler arg:   -Xlint:all,-deprecation,-dep-ann
+     [echo] compiler arg:   -Xlint:all,-deprecation,-dep-ann,-options
      [echo] ----------------------------------------------------
     [mkdir] Created dir: C:\icu4j\main\classes\localespi\out\bin
     [javac] Compiling 22 source files to C:\icu4j\main\classes\localespi\out\bin
 
-
 compile:
 
 @copy:
@@ -706,14 +719,12 @@ copy:
 @jar:
     [mkdir] Created dir: C:\icu4j\main\classes\localespi\out\lib
      [copy] Copying 1 file to C:\icu4j\main\classes\localespi\out
-      [jar] Building jar: C:\icu4j\main\classes\localespi\out\lib\icu4j-localesp
-i.jar
+      [jar] Building jar: C:\icu4j\main\classes\localespi\out\lib\icu4j-localespi.jar
 
 jar:
 
 @src-jar:
-      [jar] Building jar: C:\icu4j\main\classes\localespi\out\lib\icu4j-localesp
-i-src.jar
+      [jar] Building jar: C:\icu4j\main\classes\localespi\out\lib\icu4j-localespi-src.jar
 
 src-jar:
 
@@ -724,7 +735,7 @@ jar:
      [copy] Copying 1 file to C:\icu4j
 
 BUILD SUCCESSFUL
-Total time: 53 seconds

+Total time: 1 minute 38 seconds

Note: The above output is an example. The numbers are likely to be different with the current version ICU4J.

The following are some targets that you can provide to ant. @@ -976,9 +987,9 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in $icu4c_r

Generating Data from CLDR

Note: This procedure assumes that all 3 sources are present
-
Checkout or download CLDR version 'release-21-0-1-d01-icu49rc'
-
Checkout ICU4C with tag 'release-49-rc'
-
Checkout ICU4J with tag 'release-49-rc'
+
Checkout or download CLDR version 'release-21-0-1'
+
Checkout ICU4C with tag 'release-49-1'
+
Checkout ICU4J with tag 'release-49-1'

cd to $icu4c_root/source/data directory

Follow the instructions in $icu4c_root/source/data/cldr-icu-readme.txt

Rebuild ICU4C with the newly generated data.
@@ -990,7 +1001,7 @@ ICU4J data is built by ICU4C tools. Please see "icu4j-readme.txt" in $icu4c_r

About ICU4J Time Zone
-
ICU4J 49RC includes time zone data version 2012b, which is the latest one as of +
ICU4J 49.1 includes time zone data version 2012b, 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 -- 2.40.0