michael@0: ********************************************************************************
michael@0: * Copyright (C) 2008-2012, International Business Machines Corporation         *
michael@0: * and others. All Rights Reserved.                                             *
michael@0: *                                                                              *
michael@0: * 6/26/08 - Created by Brian Rower - heavy copying from ICU4J readme & others  *
michael@0: *                                                                              *
michael@0: ********************************************************************************
michael@0: 
michael@0: Procedures for building ICU4J data from ICU4C data:
michael@0: 
michael@0: *Setup*
michael@0: 
michael@0: In the following,
michael@0:         $icu4c_root is the ICU4C root directory
michael@0:         $icu4j_root is the ICU4J root directory
michael@0:         $jdk_bin is the JDK bin directory (for the jar tool)
michael@0: 
michael@0: 1. Download and build ICU4C. For more instructions on downloading and building
michael@0:         ICU4C, see the ICU4C readme at:
michael@0:         http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild
michael@0: 	(Windows: build as x86, Release otherwise you will have to set 'CFG' differently below.)
michael@0: 
michael@0: 	*NOTE* You should do a full rebuild after any data changes.
michael@0: 1a.  If you didn't download from Subversion, you will also need the "icu4c-*-data.zip" file.  Unpack this file and replace the icu/source/data directory's contents with the contents of the data directory from the zip file.  
michael@0: 
michael@0: 
michael@0: 2. Step 2 depends on whether you are on a Windows or a Unix-type
michael@0: platform.
michael@0: 
michael@0: *Windows* 
michael@0: 
michael@0: 2a. On the command line, cd to $icu4c_root\source\data.
michael@0: 
michael@0: 2b. On the command line,
michael@0:         nmake -f makedata.mak ICUMAKE=$icu4c_root\source\data\  CFG=x86\Release JAR="$jdk_bin\jar" ICU4J_ROOT=$icu4j_root  icu4j-data-install
michael@0: 
michael@0:        Continue with step 3 below, in Java:
michael@0: 
michael@0: 
michael@0: *Linux*
michael@0: 
michael@0:         $icu4c_build is the ICU4C root build directory,
michael@0:         which is $icu4c_root/source in an in-source build.
michael@0:         (in other words, $icu4c_build is where you ran runConfigureICU or configure)
michael@0: 
michael@0: 2c. On the command line, cd to $icu4c_build/data
michael@0: 
michael@0: 2d. Do
michael@0:         make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icu4j-data-install
michael@0: 
michael@0:        (You can omit the JAR if it's just jar.)
michael@0: 
michael@0: 	Continue with step 3, in Java:
michael@0: 
michael@0: Step 2 on either platform will produce two files: icudata.jar and
michael@0: icutzdata.jar in $icu4j_root/main/shared/data.
michael@0: 
michael@0: *Java*
michael@0: 
michael@0: 3. After the ICU4C-side steps above, build the main target of the
michael@0:         ICU4J ant build to unpack the jar files with the following commands:
michael@0: 
michael@0:         cd $icu4j_root
michael@0:         ant main