How eggert/tz works
Project type and purpose
• This is the IANA “tz” distribution: a C-based library + command-line tools + data set that represent historical and current time-zone rules worldwide.
• It is not a typical client/server or web app, but a data-driven tooling package: you compile source data into binary zoneinfo files, build a small run-time library, and install a handful of CLI utilities.
File structure
• Top-level files
• Makefile, configure‐style scripts: orchestrate build and install
• C source files (date.c, localtime.c, zic.c, zdump.c, etc.): implement library and tools
• Data directories (africa/, europe/, northamerica/, …): plain-text zone definition files
• Scripts (checklinks.awk, ziguard.awk, tzselect.ksh, workman.sh): validation, selection, migration helpers
• Documentation (tz-how-to.html, theory.html, manpages .1/.3/.5/.8): usage and design background
• Static tables (iso3166.tab, zone.tab, zone1970.tab, leap-seconds.list): reference data
• Patterns
• Layered architecture: data layer → compiler tool (zic) → binary zoneinfo layer → run-time library → CLI utilities
• Build/install: Makefile drives compilation of C sources and installation of data + binaries
README for additional insights
• Purpose: “Provide a compendium of data about the history of civil time…”
• Usage: run make install, then utilities like zdump to inspect zoneinfo
• Contribution: data fixes and enhancements welcome
Attention to detail
• Where manpages (date.1, zic.8, tzfile.5) and HTML docs sit in the install tree