1309574SglebiusREADME for the tz distribution 2309574Sglebius 3309574Sglebius"What time is it?" -- Richard Deacon as The King 4309574Sglebius"Any time you want it to be." -- Frank Baxter as The Scientist 5309574Sglebius (from the Bell System film "About Time") 6309574Sglebius 7309574SglebiusThe Time Zone Database (often called tz or zoneinfo) contains code and 8309574Sglebiusdata that represent the history of local time for many representative 9309574Sglebiuslocations around the globe. It is updated periodically to reflect 10309574Sglebiuschanges made by political bodies to time zone boundaries, UTC offsets, 11309574Sglebiusand daylight-saving rules. 12309574Sglebius 13309574SglebiusHere is a recipe for acquiring, building, installing, and testing the 14309574Sglebiustz distribution on a GNU/Linux or similar host. 15309574Sglebius 16309574SglebiusTo acquire the distribution, run the following shell commands: 17309574Sglebius 18309574Sglebius mkdir tz 19309574Sglebius cd tz 20309574Sglebius wget --retr-symlinks 'ftp://ftp.iana.org/tz/tz*-latest.tar.gz' 21309574Sglebius gzip -dc tzcode-latest.tar.gz | tar -xf - 22309574Sglebius gzip -dc tzdata-latest.tar.gz | tar -xf - 23309574Sglebius 24309574SglebiusAlternatively, the following shell commands acquire the same 25309574Sglebiusdistribution, with extra data useful for regression testing: 26309574Sglebius 27309574Sglebius wget --retr-symlinks 'ftp://ftp.iana.org/tz/tzdb-latest.tar.lz' 28309574Sglebius lzip -dc tzdb-latest.tar.lz | tar -xf - 29309574Sglebius 30309574SglebiusBe sure to read the comments in "Makefile" and make any changes needed 31309574Sglebiusto make things right for your system, especially if you are using some 32309574Sglebiusplatform other than GNU/Linux. Then run the following commands, 33309574Sglebiussubstituting your desired installation directory for "$HOME/tzdir": 34309574Sglebius 35309574Sglebius make TOPDIR=$HOME/tzdir install 36309574Sglebius $HOME/tzdir/etc/zdump -v America/Los_Angeles 37309574Sglebius 38309574SglebiusHistorical local time information has been included here to: 39309574Sglebius 40309574Sglebius* provide a compendium of data about the history of civil time 41309574Sglebius that is useful even if not 100% accurate; 42309574Sglebius 43309574Sglebius* give an idea of the variety of local time rules that have 44309574Sglebius existed in the past and thus an idea of the variety that may be 45309574Sglebius expected in the future; 46309574Sglebius 47309574Sglebius* provide a test of the generality of the local time rule description 48309574Sglebius system. 49309574Sglebius 50309574SglebiusThe information in the time zone data files is by no means authoritative; 51309574Sglebiusfixes and enhancements are welcome. Please see the file CONTRIBUTING 52309574Sglebiusfor details. 53309574Sglebius 54309574SglebiusThanks to these Time Zone Caballeros who've made major contributions to the 55309574Sglebiustime conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; 56309574SglebiusGuy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to 57309574SglebiusMichael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales 58309574Sglebiusfor testing work, and to Gwillim Law for checking local mean time data. 59309574SglebiusThanks in particular to Arthur David Olson, the project's founder and first 60309574Sglebiusmaintainer, to whom the time zone community owes the greatest debt of all. 61309574SglebiusNone of them are responsible for remaining errors. 62309574Sglebius 63309574SglebiusLook in <ftp://ftp.iana.org/tz/releases/> for updated versions of these files. 64309574Sglebius 65309574SglebiusPlease send comments or information to tz@iana.org. 66309574Sglebius 67309574Sglebius----- 68309574Sglebius 69309574SglebiusThis file is in the public domain, so clarified as of 2009-05-17 by 70309574SglebiusArthur David Olson. The other files in this distribution are either 71309574Sglebiuspublic domain or BSD licensed; see the file LICENSE for details. 72