Annotation of src/lib/libc/time/README, Revision 184.108.40.206
1.7 christos 1: README for the tz distribution
1.4 jtc 3: "What time is it?" -- Richard Deacon as The King
4: "Any time you want it to be." -- Frank Baxter as The Scientist
5: (from the Bell System film "About Time")
220.127.116.11! pgoyette 7: The Time Zone Database (called tz, tzdb or zoneinfo) contains code and
1.8 christos 8: data that represent the history of local time for many representative
9: locations around the globe. It is updated periodically to reflect
10: changes made by political bodies to time zone boundaries, UTC offsets,
11: and daylight-saving rules.
1.12 christos 13: See <https://www.iana.org/time-zones/repository/tz-link.html> or the
1.13 christos 14: file tz-link.html for how to acquire the code and data. Once acquired,
1.12 christos 15: read the comments in the file 'Makefile' and make any changes needed
1.5 kleink 16: to make things right for your system, especially if you are using some
17: platform other than GNU/Linux. Then run the following commands,
18: substituting your desired installation directory for "$HOME/tzdir":
20: make TOPDIR=$HOME/tzdir install
1.13 christos 21: $HOME/tzdir/usr/bin/zdump -v America/Los_Angeles
1.4 jtc 22:
18.104.22.168! pgoyette 23: This database of historical local time information has several goals:
1.6 mlelstv 24:
22.214.171.124! pgoyette 25: * Provide a compendium of data about the history of civil time that
! 26: is useful even if not 100% accurate.
1.4 jtc 27:
126.96.36.199! pgoyette 28: * Give an idea of the variety of local time rules that have existed
! 29: in the past and thus may be expected in the future.
1.4 jtc 30:
188.8.131.52! pgoyette 31: * Test the generality of the local time rule description system.
1.4 jtc 32:
33: The information in the time zone data files is by no means authoritative;
1.9 christos 34: fixes and enhancements are welcome. Please see the file CONTRIBUTING
35: for details.
1.4 jtc 36:
1.9 christos 37: Thanks to these Time Zone Caballeros who've made major contributions to the
38: time conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz;
1.4 jtc 39: Guy Harris; Mark Horton; John Mackin; and Bradley White. Thanks also to
40: Michael Bloom, Art Neilson, Stephen Prince, John Sovereign, and Frank Wales
41: for testing work, and to Gwillim Law for checking local mean time data.
1.8 christos 42: Thanks in particular to Arthur David Olson, the project's founder and first
1.9 christos 43: maintainer, to whom the time zone community owes the greatest debt of all.
1.4 jtc 44: None of them are responsible for remaining errors.
1.10 christos 46: -----
48: This file is in the public domain, so clarified as of 2009-05-17 by
49: Arthur David Olson. The other files in this distribution are either
50: public domain or BSD licensed; see the file LICENSE for details.