@@ -0,0 +1,49 @@
1+timezone-olson version 0.1.0
3+This package provides a parser and renderer for binary Olson timezone
4+files whose format is specified by the tzfile(5) man page on Unix-like
5+systems. For more information about this format, see
6+<http://www.twinsun.com/tz/tz-link.htm>. Functions are provided for
7+converting the parsed data into 'TimeZoneSeries' objects from the
8+timezone-series package. On many platforms, binary Olson timezone
9+files suitable for use with this package are available in the
10+directory /usr/share/zoneinfo and its subdirectories on your computer.
12+This version of timezone-olson is highly experimental. Expect there
13+to be bugs, and do not rely on any stability of the exposed
16+Copyright (c) 2010 Yitzchak Gale. All rights reserved.
17+For licensing information, see the BSD3-style license in the file
18+LICENSE that was originally distributed by the author together with
21+This package is part of the time-ng project:
22+http://projects.haskell.org/time-ng/
24+Send suggestions, bug reports, and patches to:
25+yitz@community.haskell.org
29+To install the latest version of this package, make sure that
30+cabal-install is installed on your system (it is if you have installed
31+the Haskell Platform) and type the commands:
34+cabal install timezone-olson
38+This package also provides two Haskell files, each of which can be
39+compiled into a command-line utility that might be helpful for testing
42+zhdump.hs: A clone of zdump(8), including most of its bugs, that
43+ is usually present on systems that have an Olson timezone
44+ database, except hzdump takes paths to timezone files
45+ instead of timezone identifiers on the command line.
47+catTZ: Read and parse a timezone file, then render it. With the
48+ -i flag, interprets the timezone data as a TimeZoneSeries
49+ object before rendering.