@@ -12,7 +12,10 @@ VERSION= unknown
1212# Email address for bug reports.
13131414
15- # Choose source data features. To get new features right away, use:
15+ # DATAFORM selects the data format.
16+ # Available formats represent essentially the same data, albeit
17+ # possibly with minor discrepancies that users are not likely to notice.
18+ # To get new features and the best data right away, use:
1619# DATAFORM= vanguard
1720# To wait a while before using new features, to give downstream users
1821# time to upgrade zic (the default), use:
@@ -33,11 +36,11 @@ DATAFORM= main
3336LOCALTIME = GMT
3437
3538# If you want something other than Eastern United States time as a template
36- # for handling POSIX-style timezone environment variables,
39+ # for handling ruleless POSIX-style timezone environment variables,
3740# change the line below (after finding the timezone you want in the
3841# one of the $(TDATA) source files, or adding it to a source file).
39- # When a POSIX-style environment variable is handled, the rules in the
40- # template file are used to determine "spring forward" and "fall back" days and
42+ # A ruleless environment setting like TZ='CST6CDT' uses the rules in the
43+ # template file to determine "spring forward" and "fall back" days and
4144# times; the environment variable itself specifies UT offsets of standard and
4245# daylight saving time.
4346# Alternatively, if you discover you've got the wrong timezone, you can just
@@ -46,7 +49,6 @@ LOCALTIME= GMT
4649# Use the command
4750# make zonenames
4851# to get a list of the values you can use for POSIXRULES.
49- # If you want POSIX compatibility, use "America/New_York".
5052
5153POSIXRULES = America/New_York
5254
@@ -113,8 +115,8 @@ TIME_T_ALTERNATIVES = $(TIME_T_ALTERNATIVES_HEAD) $(TIME_T_ALTERNATIVES_TAIL)
113115TIME_T_ALTERNATIVES_HEAD = int64_t
114116TIME_T_ALTERNATIVES_TAIL = int32_t uint32_t uint64_t
115117
116- # What kind of TZif data files to generate.
117- # (TZif is the binary time zone data format that zic generates.)
118+ # What kind of TZif data files to generate. (TZif is the binary time
119+ # zone data format that zic generates; see Internet RFC 8536 .)
118120# If you want only POSIX time, with time values interpreted as
119121# seconds since the epoch (not counting leap seconds), use
120122# REDO= posix_only
@@ -360,6 +362,9 @@ LEAPSECONDS=
360362zic = ./zic
361363ZIC = $(zic ) $(ZFLAGS )
362364
365+ # To shrink the size of installed TZif files,
366+ # append "-r @N" to omit data before N-seconds-after-the-Epoch.
367+ # See the zic man page for more about -r.
363368ZFLAGS =
364369
365370# How to use zic to install TZif files.
@@ -491,7 +496,8 @@ MANTXTS= newctime.3.txt newstrftime.3.txt newtzset.3.txt \
491496COMMON= calendars CONTRIBUTING LICENSE Makefile \
492497 NEWS README theory.html version
493498WEB_PAGES= tz-art.html tz-how-to.html tz-link.html
494- CHECK_WEB_PAGES=check_tz-art.html check_tz-how-to.html check_tz-link.html
499+ CHECK_WEB_PAGES=check_theory.html check_tz-art.html \
500+ check_tz-how-to.html check_tz-link.html
495501DOCS= $( MANS) date.1 $( MANTXTS) $( WEB_PAGES)
496502PRIMARY_YDATA= africa antarctica asia australasia \
497503 europe northamerica southamerica
@@ -804,9 +810,10 @@ check_tzs: $(TZS) $(TZS_NEW)
804810 touch $@
805811
806812check_web: $( CHECK_WEB_PAGES)
813+ check_theory.html: theory.html
807814check_tz-art.html: tz-art.html
808815check_tz-link.html: tz-link.html
809- check_tz-art.html check_tz-link.html:
816+ check_theory.html check_tz-art.html check_tz-link.html:
810817 $( CURL) -s S --url https://validator.w3.org/nu/ -F out= gnu \
811818 -F file= @$$ (expr $@ : ' check_\(.*\)' ) -o $@ .out && \
812819 test ! -s $@ .out || { cat $@ .out; exit 1; }
@@ -840,11 +847,13 @@ check_zishrink_posix check_zishrink_right: \
840847 touch $@
841848
842849clean_misc:
850+ rm -fr check_* .dir
843851 rm -f * .o * .out $( TIME_T_ALTERNATIVES) \
844852 check_* core typecheck_* \
845853 date tzselect version.h zdump zic yearistype libtz.a
846854clean: clean_misc
847- rm -fr * .dir * .zi tzdb-* / $( TZS_NEW)
855+ rm -fr * .dir tzdb-* /
856+ rm -f * .zi $( TZS_NEW)
848857
849858maintainer-clean: clean
850859 @echo ' This command is intended for maintainers to use; it'
0 commit comments