scuffed-code/icu4c/source/tools/tzcode
2013-03-06 22:29:55 +00:00
..
asctime.c ICU-4716 initial checkin of zic utilities 2006-08-03 23:40:18 +00:00
ialloc.c ICU-4716 initial checkin of zic utilities 2006-08-03 23:40:18 +00:00
icuzdump.cpp ICU-5135 tzcode update 2007-08-20 20:14:22 +00:00
icuzdump.vcproj ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
icuzones ICU-7908 Changed the definition of SystemV zones to align them to Olson. By the change, zoneinfo resource was regenerated. Also, regenerated windowsZones.txt from the latest CLDR data. 2010-09-08 14:49:39 +00:00
localtime.c ICU-6696 Updated ICU zic to handle final rules without actual time changes (America/Resolute in 2009a). Also merged tzcode2009a to the ICU local copies. 2009-01-22 21:20:41 +00:00
Makefile.in ICU-9732 Fixed tzdata build problem - additional fix to r32877 2013-03-06 22:29:55 +00:00
private.h ICU-6696 Updated ICU zic to handle final rules without actual time changes (America/Resolute in 2009a). Also merged tzcode2009a to the ICU local copies. 2009-01-22 21:20:41 +00:00
readme.txt ICU-5941 Fix out of date URLs 2007-10-09 08:44:58 +00:00
scheck.c ICU-4716 initial checkin of zic utilities 2006-08-03 23:40:18 +00:00
tz2icu.cpp ICU-5624 64bit time zone transition support changes merged from Yoshito's work branch. Also updated time zone code to use region mapping data only from zoneinfo64 (so zoneFormatting data in supplementalData is no longer used). 2010-02-24 07:54:30 +00:00
tz2icu.h ICU-5624 64bit time zone transition support changes merged from Yoshito's work branch. Also updated time zone code to use region mapping data only from zoneinfo64 (so zoneFormatting data in supplementalData is no longer used). 2010-02-24 07:54:30 +00:00
tz.alias ICU-5315 Merge ICU backward compatibility zone definitions to icuzones. Also run Olson zic/zdump for data including icuzones to compare all ICU timezone transitions with the Olson stock code side by side. 2007-04-03 04:36:52 +00:00
tzfile.h ICU-4716 initial checkin of zic utilities 2006-08-03 23:40:18 +00:00
tzselect.ksh ICU-4716 initial checkin of zic utilities 2006-08-03 23:40:18 +00:00
zdump.c ICU-8289 tzdata2011c to ICU4C trunk 2011-03-07 20:55:49 +00:00
zic.c ICU-5624 64bit time zone transition support changes merged from Yoshito's work branch. Also updated time zone code to use region mapping data only from zoneinfo64 (so zoneFormatting data in supplementalData is no longer used). 2010-02-24 07:54:30 +00:00

**********************************************************************
* Copyright (c) 2003-2007, International Business Machines
* Corporation and others.  All Rights Reserved.
**********************************************************************
* Author: Alan Liu
* Created: August 18 2003
* Since: ICU 2.8
**********************************************************************

Note:  this directory currently contains tzcode as of tzcode2006h.tar.gz
   with localtime.c  patches from tzcode2006i.tar.gz


----------------------------------------------------------------------
OVERVIEW

This file describes the tools in icu/source/tools/tzcode

The purpose of these tools is to process the zoneinfo or "Olson" time
zone database into a form usable by ICU4C (release 2.8 and later).
Unlike earlier releases, ICU4C 2.8 supports historical time zone
behavior, as well as the full set of Olson compatibility IDs.

References:

ICU4C:  http://www.icu-project.org/
Olson:  ftp://elsie.nci.nih.gov/pub/

----------------------------------------------------------------------
ICU4C vs. ICU4J

For ICU releases >= 2.8, both ICU4C and ICU4J implement full
historical time zones, based on Olson data.  The implementations in C
and Java are somewhat different.  The C implementation is a
self-contained implementation, whereas ICU4J uses the underlying JDK
1.3 or 1.4 time zone implementation.

Older versions of ICU (C and Java <= 2.6) implement a "present day
snapshot".  This only reflects current time zone behavior, without
historical variation.  Furthermore, it lacks the full set of Olson
compatibility IDs.

----------------------------------------------------------------------
BACKGROUND

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/

  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

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

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:

   $ cd {path_to}/icu/source/tools/tzcode
   $ wget "ftp://elsie.nci.nih.gov/pub/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.

3. Build ICU normally. You will see a notice "updating zoneinfo.txt..."

### 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 zoneinfo.txt (from its location at
   {path_to}/icu/source/data/misc/zoneinfo.txt) into SVN.