1309568SglebiusREADME for the tz distribution 2309568Sglebius 3309568Sglebius"What time is it?" -- Richard Deacon as The King 4309568Sglebius"Any time you want it to be." -- Frank Baxter as The Scientist 5309568Sglebius (from the Bell System film "About Time") 6309568Sglebius 7309568SglebiusThe Time Zone Database (often called tz or zoneinfo) contains code and 8309568Sglebiusdata that represent the history of local time for many representative 9309568Sglebiuslocations around the globe. It is updated periodically to reflect 10309568Sglebiuschanges made by political bodies to time zone boundaries, UTC offsets, 11309568Sglebiusand daylight-saving rules. 12309568Sglebius 13309568SglebiusHere is a recipe for acquiring, building, installing, and testing the 14309568Sglebiustz distribution on a GNU/Linux or similar host. 15309568Sglebius 16309568SglebiusTo acquire the distribution, run the following shell commands: 17309568Sglebius 18309568Sglebius mkdir tz 19309568Sglebius cd tz 20309568Sglebius wget --retr-symlinks 'ftp://ftp.iana.org/tz/tz*-latest.tar.gz' 21309568Sglebius gzip -dc tzcode-latest.tar.gz | tar -xf - 22309568Sglebius gzip -dc tzdata-latest.tar.gz | tar -xf - 23309568Sglebius 24309568SglebiusAlternatively, the following shell commands acquire the same 25309568Sglebiusdistribution, with extra data useful for regression testing: 26309568Sglebius 27309568Sglebius wget --retr-symlinks 'ftp://ftp.iana.org/tz/tzdb-latest.tar.lz' 28309568Sglebius lzip -dc tzdb-latest.tar.lz | tar -xf - 29309568Sglebius 30309568SglebiusBe sure to read the comments in "Makefile" and make any changes needed 31309568Sglebiusto make things right for your system, especially if you are using some 32309568Sglebiusplatform other than GNU/Linux. Then run the following commands, 33309568Sglebiussubstituting your desired installation directory for "$HOME/tzdir": 34309568Sglebius 35309568Sglebius make TOPDIR=$HOME/tzdir install 36309568Sglebius $HOME/tzdir/etc/zdump -v America/Los_Angeles 37309568Sglebius 38309568SglebiusHistorical local time information has been included here to: 39309568Sglebius 40309568Sglebius* provide a compendium of data about the history of civil time 41309568Sglebius that is useful even if not 100% accurate; 42309568Sglebius 43309568Sglebius* give an idea of the variety of local time rules that have 44309568Sglebius existed in the past and thus an idea of the variety that may be 45309568Sglebius expected in the future; 46309568Sglebius 47309568Sglebius* provide a test of the generality of the local time rule description 48309568Sglebius system. 49309568Sglebius 50309568SglebiusThe information in the time zone data files is by no means authoritative; 51309568Sglebiusfixes and enhancements are welcome. Please see the file CONTRIBUTING 52309568Sglebiusfor details. 53309568Sglebius 54309568SglebiusThanks to these Time Zone Caballeros who've made major contributions to the 55309568Sglebiustime conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; 56309568SglebiusGuy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to 57309568SglebiusMichael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales 58309568Sglebiusfor testing work, and to Gwillim Law for checking local mean time data. 59309568SglebiusThanks in particular to Arthur David Olson, the project's founder and first 60309568Sglebiusmaintainer, to whom the time zone community owes the greatest debt of all. 61309568SglebiusNone of them are responsible for remaining errors. 62309568Sglebius 63309568SglebiusLook in <ftp://ftp.iana.org/tz/releases/> for updated versions of these files. 64309568Sglebius 65309568SglebiusPlease send comments or information to tz@iana.org. 66309568Sglebius 67309568Sglebius----- 68309568Sglebius 69309568SglebiusThis file is in the public domain, so clarified as of 2009-05-17 by 70309568SglebiusArthur David Olson. The other files in this distribution are either 71309568Sglebiuspublic domain or BSD licensed; see the file LICENSE for details. 72