**********************************************************************
-* Copyright (c) 2003-2004, International Business Machines
+* Copyright (c) 2003-2014, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* Author: Alan Liu
* Since: ICU 2.8
**********************************************************************
+Note: this directory currently contains tzcode as of tzcode2014b.tar.gz
+ with localtime.c patches from tzcode2014b.tar.gz
+
+
----------------------------------------------------------------------
OVERVIEW
References:
-ICU4C: http://oss.software.ibm.com/icu/
-Olson: ftp://elsie.nci.nih.gov/pub/
+ICU4C: http://www.icu-project.org/
+Olson: ftp://ftp.iana.org/tz/releases/
----------------------------------------------------------------------
ICU4C vs. ICU4J
to describe the behavior of time zones. The package consists of
several parts. E.g.:
- Index of ftp://elsie.nci.nih.gov/pub/
+ Index of ftp://ftp.iana.org/tz/releases/
- classictzcode.tar.gz 65 KB 12/10/1994 12:00:00 AM
- classictzdata.tar.gz 67 KB 12/10/1994 12:00:00 AM
- e5+57.tar.gz 2909 KB 3/22/1993 12:00:00 AM
- iso8601.ps.gz 16 KB 7/27/1996 12:00:00 AM
- leastsq.xls 49 KB 4/24/1997 12:00:00 AM
- ltroff.tar.gz 36 KB 7/16/1993 12:00:00 AM
- pi.shar.gz 4 KB 3/9/1994 12:00:00 AM
- tzarchive.gz 3412 KB 8/18/2003 4:00:00 AM
- tzcode2003a.tar.gz 98 KB 3/24/2003 2:32:00 PM
- tzdata2003a.tar.gz 132 KB 3/24/2003 2:32:00 PM
+ tzcode2014b.tar.gz 172 KB 3/25/2014 05:11:00 AM
+ tzdata2014b.tar.gz 216 KB 3/25/2014 05:11:00 AM
-ICU only uses the tzcodeYYYYV.tar.gz and tzdataYYYYV.tar.gz files,
+ICU only uses the tzdataYYYYV.tar.gz files,
where YYYY is the year and V is the version letter ('a'...'z').
+This directory has partial contents of tzcode checked into ICU
+
----------------------------------------------------------------------
HOWTO
-1. Obtain the current versions of tzcodeYYYYV.tar.gz (aka `tzcode')
- and tzdataYYYYV.tar.gz (aka `tzdata') from the FTP site given
- above. Either manually download or use wget:
+0. Note, these instructions will only work on POSIX type systems.
- $ cd {path_to}/icu/source/tools/tzcode
- $ wget "ftp://elsie.nci.nih.gov/pub/tz*.tar.gz"
+1. Obtain the current versions of tzdataYYYYV.tar.gz (aka `tzdata') from
+ the FTP site given above. Either manually download or use wget:
-2. Unpack tzcode and tzdata directly into the directory tzcode:
+ $ cd {path_to}/icu/source/tools/tzcode
+ $ wget "ftp://ftp.iana.org/tz/releases/tzdata*.tar.gz"
- $ tar xzvf tzcode*.tar.gz
- $ tar xzvf tzdata*.tar.gz
+2. Copy only one tzdata*.tar.gz file into the icu/source/tools/tzcode/
+ directory (this directory).
*** Make sure you only have ONE FILE named tzdata*.tar.gz in the
directory.
- *** Do NOT delete the tzdata*.tar.gz file.
-
- The Makefile looks in the current directory to determine the
- version of Olson data it is building by looking for tzdata*.tar.gz.
-3. Apply the ICU patch to zic.c:
+3. Build ICU normally. You will see a notice "updating zoneinfo.txt..."
- $ patch < patch-icu-tzcode
+### Following instructions for ICU maintainers only ###
- If patch complains at this point, there is a mismatch that must be
- manually addressed. See the CVS log of `patch-icu-tzcode' for
- version details.
+4. Obtain the current version of tzcodeYYYY.tar.gz from the FTP site to
+ this directory.
-4. Build:
+5. Run make target "check-dump". This target extract makes the original
+ tzcode and compile the original tzdata with icu supplemental data
+ (icuzones). Then it makes zdump / icuzdump and dump all time
+ transitions for all ICU timezone to files under zdumpout / icuzdumpout
+ directory. When they produce different results, the target returns
+ the error.
- $ make icu_data
+6. Don't forget to check in the new zoneinfo64.txt (from its location at
+ {path_to}/icu/source/data/misc/zoneinfo64.txt) into SVN.
-5. Copy the data files to the correct location in the ICU4C/ICU4J
- source trees:
-
- $ cp zoneinfo.txt ../../../data/misc/
- $ cp ZoneMetaData.java {path_to}/icu4j/src/com/ibm/icu/impl
-
-6. Rebuild ICU:
-
- $ cd ../../../
- $ {*make}
-
-7. Don't forget to check in the new zoneinfo.txt (from its location at
- {path_to}/icu/source/data/misc/zoneinfo.txt) into CVS.
-
-----------------------------------------------------------------------
-HOWTO regenerate patch-icu-tzcode
-
-If you need to edit any of the tzcode* files, you will need to
-regenerate the patch file as follows.
-
-1. Follow the above instructions to extract and patch the tzcode*
- files in {path_to}/icu/source/tools/tzcode. Modify any of the
- tzcode files.
-
-2. Extract a clean set of the tzcode* files into a new directory,
- ../tzcode.orig/:
-
- $ mkdir ../tzcode.orig
- $ cd ../tzcode.orig
- $ tar xzf ../tzcode/tzcode*.tar.gz
- $ cd ../tzcode
-
-3. Compute diffs, ignoring files that are in only one directory:
-
- $ diff -ur ../tzcode.orig . | grep -vE -e "^Only in " > patch-icu-tzcode
-
-4. Test the patch-icu-tzcode file by regenerating and diffing the
- files again in another directory. The expected output from the
- final diff command is *nothing*.
-
- $ mkdir ../tzcode.new
- $ cd ../tzcode.new
- $ tar xzf ../tzcode/tzcode*.tar.gz
- $ patch < ../tzcode/patch-icu-tzcode
- $ cd ../tzcode
- $ diff -ur ../tzcode.new . | grep -vE -e "^Only in "
-
-5. Check in the new patch-icu-tzcode file.
-
-----------------------------------------------------------------------
-eof
projects / apple / icu.git / blobdiff