ICU-57163.0.1.tar.gz

[apple/icu.git] / icuSources / tools / tzcode / readme.txt

diff --git a/icuSources/tools/tzcode/readme.txt b/icuSources/tools/tzcode/readme.txt
index 656a64887bf7c9596b64506f347cfe14b9dfb645..49d33368136a06ee45a4f78d5bafbb8283877547 100644 (file)
--- a/icuSources/tools/tzcode/readme.txt
+++ b/icuSources/tools/tzcode/readme.txt
@@ -1,5 +1,5 @@
 **********************************************************************
-* Copyright (c) 2003-2006, International Business Machines
+* Copyright (c) 2003-2014, International Business Machines
 * Corporation and others.  All Rights Reserved.
 **********************************************************************
 * Author: Alan Liu
@@ -7,8 +7,8 @@
 * Since: ICU 2.8
 **********************************************************************
 
-Note:  this directory currently contains tzcode as of tzcode2006h.tar.gz
-   with localtime.c  patches from tzcode2006i.tar.gz
+Note:  this directory currently contains tzcode as of tzcode2014b.tar.gz
+   with localtime.c  patches from tzcode2014b.tar.gz
 
 
 ----------------------------------------------------------------------
@@ -23,8 +23,8 @@ behavior, as well as the full set of Olson compatibility IDs.
 
 References:
 
-ICU4C:  http://icu.sourceforge.net/
-Olson:  ftp://elsie.nci.nih.gov/pub/
+ICU4C:  http://www.icu-project.org/
+Olson:  ftp://ftp.iana.org/tz/releases/
 
 ----------------------------------------------------------------------
 ICU4C vs. ICU4J
@@ -47,18 +47,10 @@ The zoneinfo or "Olson" time zone package is used by various systems
 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 tzdataYYYYV.tar.gz files,
 where YYYY is the year and V is the version letter ('a'...'z').
@@ -70,19 +62,32 @@ HOWTO
 
 0. Note, these instructions will only work on POSIX type systems.
 
-1. Obtain the current versions of tzdataYYYYV.tar.gz (aka `tzdata') from the FTP site given
-   above.  Either manually download or use wget:
+1. Obtain the current versions of tzdataYYYYV.tar.gz (aka `tzdata') from
+   the FTP site given above.  Either manually download or use wget:
 
    $ cd {path_to}/icu/source/tools/tzcode
-   $ wget "ftp://elsie.nci.nih.gov/pub/tzdata*.tar.gz"
+   $ wget "ftp://ftp.iana.org/tz/releases/tzdata*.tar.gz"
 
-2. copy only one tzdata*.tar.gz file into the icu/source/data/in/ directory (you may have to create this directory)
+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.
 
 3. Build ICU normally. You will see a notice "updating zoneinfo.txt..."
 
-4. For ICU maintainers, don't forget to check in the new
-    zoneinfo.txt (from its location at
-   {path_to}/icu/source/data/misc/zoneinfo.txt) into CVS.
+### Following instructions for ICU maintainers only ###
+
+4. Obtain the current version of tzcodeYYYY.tar.gz from the FTP site to
+   this directory.
+
+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.
+
+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.
+