source/data/icu4j-readme.txt

********************************************************************************
* Copyright (C) 2008-2009, International Business Machines Corporation         *
* and others. All Rights Reserved.                                             *
*                                                                              *
* 6/26/08 - Created by Brian Rower - heavy copying from ICU4J readme & others  *
*                                                                              *
********************************************************************************

Procedures for building ICU4J data from ICU4C data:

*Setup*

In the following,
        $icu4c_root is the ICU4C root directory
        $icu4j_root is the ICU4J root directory
        $jdk_bin is the JDK bin directory (for the jar tool)

1. Download and build ICU4C. For more instructions on downloading and building
        ICU4C, see the ICU4C readme at:
        http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild

*Windows*

2. On the command line, cd to $icu4c_root\source\data.

3. Do
        nmake -f makedata.mak ICUMAKE=$icu4c_root\source\data\ CFG=x86\Release JAR="$jdk_bin\jar" ICU4J_ROOT=$icu4j_root icudata.jar testdata.jar

        (You can omit the ICU4J_ROOT argument to skip the final copying.)

*Linux*

        $icu4c_build is the ICU4C root build directory,
        which is $icu4c_root/source in an in-source build

2. On the command line, cd to $icu4c_build/data.

3. Do
        make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icudata.jar
        cd ../test/testdata
        make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root testdata.jar

        (You can omit the ICU4J_ROOT argument to skip the final copying.)
        (You can omit the JAR if it's just jar.)

*Java*

After the ICU4C-side steps above, build the core-data and core-test-data targets of the
        ICU4J ant build to unpack the jar files  with the following commands:

        cd $icu4j_root
        ant core-data core-test-data

* Alternative instructions *****************************************************

Procedures for building ICU4J data from ICU4C data on a Unix system:

1. Download and build ICU4C. For more instructions on downloading and building
        ICU4C, see the ICU4C readme at:
        http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild

2. In your shell, navigate to $icu4c_root/source/tools/genrb. $icu4c_root is 
        the root directory of ICU4C source package.

3. Create a new file named "Makefile.local" in this directory. In this file 
        set the ICU4J_HOME variable to be the root path of ICU4J. 
        Ex: ICU4J_HOME=/home/srl/icu4j

4. If there are spaces in your Java bin directory path (which is especially 
        common using cygwin)
        (EX: /cygdrive/c/Program Files/Java/jdk1.5.0_15/bin), you may need to 
        set GENDTJAR_JARHOME in Makefile.local. On a standard Unix based system, 
        with the Java bin directory in your PATH, this step is not required.

        You can set GENDTJAR_JARHOME by hard coding the path to the Java 
        bin directory.

        For example, on Cygwinc (notice the backslash used for the space):
                GENDTJAR_JARHOME=/cygdrive/c/Program\ Files/Java/jdk1.5.0_15/bin

5. In this same directory $icu4c_root/source/tools/genrb, 
        run the command 'make build-icu4j'

6. Build the resources target of the ICU4J ant build to unpack the jar files 
        with the following commands:
         cd $icu4j_root
         ant resources

********************************************************************************

If the above procedure fails to work, you may attempt to use the 
old procedure which uses less automation & path "guessing":

1. Download and build ICU4C. For more instructions on downloading and building
        ICU4C, see the ICU4C readme at:
        http://source.icu-project.org/repos/icu/icu/tags/release-3-8/readme.html#HowToBuild

2. Change directory to $icu4c_root/source/tools/genrb. $icu4c_root is the root 
        directory of ICU4C source package.

3. Run gendtjar.pl from that directory itself with the command:
        ./gendtjar.pl 	--icu-root=$icu4c_root --jar=$jdk_home/bin 
                        --icu4j-root=$icu4j_root

        e.g.
        ./gendtjar.pl --icu-root=$HOME/icu4c --jar=/usr/local/bin/java/bin/ --icu4j-root=$HOME/icu4j

        Execution of gendtjar.pl script will create the required jar files in
        $icu4c_root/source/tools/genrb/temp and then copy them to their 
        final locations in the ICU4J structure:
                $icu4j_root/src/com/ibm/icu/impl/data 
        and 
                $icu4j_root/src/com/ibm/icu/dev/data.

4. Build resources target of ant to unpack the jar files 
        with the following commands:

        cd $icu4j_root
        ant resources

Note: if gendtjar.pl does not work, the --verbose option can help in 
        debugging why it went wrong.

********************************************************************************