1309583SglebiusREADME for the tz distribution
2309583Sglebius
3309583Sglebius"What time is it?" -- Richard Deacon as The King
4309583Sglebius"Any time you want it to be." -- Frank Baxter as The Scientist
5309583Sglebius					(from the Bell System film "About Time")
6309583Sglebius
7309583SglebiusThe Time Zone Database (often called tz or zoneinfo) contains code and
8309583Sglebiusdata that represent the history of local time for many representative
9309583Sglebiuslocations around the globe.  It is updated periodically to reflect
10309583Sglebiuschanges made by political bodies to time zone boundaries, UTC offsets,
11309583Sglebiusand daylight-saving rules.
12309583Sglebius
13325324SgordonSee <https://www.iana.org/time-zones/repository/tz-link.html> or the
14325324Sgordonfile tz-link.htm for how to acquire the code and data.  Once acquired,
15325324Sgordonread the comments in the file 'Makefile' and make any changes needed
16309583Sglebiusto make things right for your system, especially if you are using some
17309583Sglebiusplatform other than GNU/Linux.  Then run the following commands,
18309583Sglebiussubstituting your desired installation directory for "$HOME/tzdir":
19309583Sglebius
20309583Sglebius	make TOPDIR=$HOME/tzdir install
21309583Sglebius	$HOME/tzdir/etc/zdump -v America/Los_Angeles
22309583Sglebius
23309583SglebiusHistorical local time information has been included here to:
24309583Sglebius
25309583Sglebius*	provide a compendium of data about the history of civil time
26309583Sglebius	that is useful even if not 100% accurate;
27309583Sglebius
28309583Sglebius*	give an idea of the variety of local time rules that have
29309583Sglebius	existed in the past and thus an idea of the variety that may be
30309583Sglebius	expected in the future;
31309583Sglebius
32309583Sglebius*	provide a test of the generality of the local time rule description
33309583Sglebius	system.
34309583Sglebius
35309583SglebiusThe information in the time zone data files is by no means authoritative;
36309583Sglebiusfixes and enhancements are welcome.  Please see the file CONTRIBUTING
37309583Sglebiusfor details.
38309583Sglebius
39309583SglebiusThanks to these Time Zone Caballeros who've made major contributions to the
40309583Sglebiustime conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz;
41309583SglebiusGuy Harris; Mark Horton; John Mackin; and Bradley White.  Thanks also to
42309583SglebiusMichael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales
43309583Sglebiusfor testing work, and to Gwillim Law for checking local mean time data.
44309583SglebiusThanks in particular to Arthur David Olson, the project's founder and first
45309583Sglebiusmaintainer, to whom the time zone community owes the greatest debt of all.
46309583SglebiusNone of them are responsible for remaining errors.
47309583Sglebius
48309583Sglebius-----
49309583Sglebius
50309583SglebiusThis file is in the public domain, so clarified as of 2009-05-17 by
51309583SglebiusArthur David Olson.  The other files in this distribution are either
52309583Sglebiuspublic domain or BSD licensed; see the file LICENSE for details.
53