[tz] [PROPOSED] Internet RFC 8536 has been published

Thu Feb 14 01:21:17 UTC 2019

* Makefile, NEWS, theory.html, tz-link.html, tzfile.5, tzfile.h:
Mention the new RFC.
---
 Makefile     |  4 ++--
 NEWS         |  2 ++
 theory.html  |  4 +++-
 tz-link.html | 13 ++++++-------
 tzfile.5     | 14 ++++++++++++--
 tzfile.h     |  3 +++
 6 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/Makefile b/Makefile
index 1e0a5e4..680f040 100644
--- a/Makefile
+++ b/Makefile
@@ -115,8 +115,8 @@ TIME_T_ALTERNATIVES = $(TIME_T_ALTERNATIVES_HEAD) $(TIME_T_ALTERNATIVES_TAIL)
 TIME_T_ALTERNATIVES_HEAD = int64_t
 TIME_T_ALTERNATIVES_TAIL = int32_t uint32_t uint64_t
 
-# What kind of TZif data files to generate.
-# (TZif is the binary time zone data format that zic generates.)
+# What kind of TZif data files to generate.  (TZif is the binary time
+# zone data format that zic generates; see Internet RFC 8536.)
 # If you want only POSIX time, with time values interpreted as
 # seconds since the epoch (not counting leap seconds), use
 #	REDO=		posix_only
diff --git a/NEWS b/NEWS
index 7a84052..f5d708c 100644
--- a/NEWS
+++ b/NEWS
@@ -14,6 +14,8 @@ Unreleased, experimental changes
 
   Changes to documentation
 
+    Mention Internet RFC 8536 (February 2019), which documents TZif.
+
     tz-link.html now cites tzdata-meta
     <https://tzdata-meta.timtimeonline.com/>.
 
diff --git a/theory.html b/theory.html
index a8da065..5ea1369 100644
--- a/theory.html
+++ b/theory.html
@@ -983,7 +983,9 @@ an older <code>zic</code>.
     constrained to be a string containing abbreviations
     and numeric data as described <a href="#POSIX">above</a>.
     The file's format is <dfn><abbr>TZif</abbr></dfn>,
-    a timezone information format that contains binary data.
+    a timezone information format that contains binary data; see
+    <a href="https://tools.ietf.org/html/8536">Internet
+    <abbr>RFC</abbr> 8536</a>.
     The daylight saving time rules to be used for a
     particular timezone are encoded in the
     <abbr>TZif</abbr> file; the format of the file allows <abbr>US</abbr>,
diff --git a/tz-link.html b/tz-link.html
index efeacd0..89ebd40 100644
--- a/tz-link.html
+++ b/tz-link.html
@@ -144,7 +144,9 @@ After obtaining the code and data files, see the
 <code>README</code> file for what to do next.
 The code lets you compile the <code><abbr>tz</abbr></code> source files into
 machine-readable binary files, one for each location. The binary files
-are in a special timezone information format (<dfn><abbr>TZif</abbr></dfn>).
+are in a special timezone information format (<dfn><abbr>TZif</abbr></dfn>)
+specified by <a href="https://tools.ietf.org/html/8536">Internet
+<abbr>RFC</abbr> 8536</a>.
 The code also lets
 you read a <abbr>TZif</abbr> file and interpret timestamps for that
 location.</p>
@@ -282,15 +284,12 @@ along with <a href="https://tools.ietf.org/html/rfc7809">CalDAV</a>
 (Internet <abbr>RFC</abbr> 7809), a calendar access protocol for
 transferring time zone data by reference.
 The <a href="https://www.ietf.org/mailman/listinfo/tzdist-bis">tzdist-bis
-mailing list</a> discusses two Internet drafts: <a
+mailing list</a> discusses the Internet draft <a
 id="TZDIST-Geolocate"
 href="https://tools.ietf.org/html/draft-murchison-tzdist-geolocate">TZDIST
-Geolocate Extension</a> lets a client determine its timezone
+Geolocate Extension</a>, which lets a client determine its timezone
 from its geographic location using a <a
-href="https://tools.ietf.org/html/rfc5870">'geo' URI</a>, and
-<a href="https://tools.ietf.org/html/draft-murchison-tzdist-tzif">The
-Time Zone Information Format (<abbr>TZif</abbr>)</a> specifies the format of
-<abbr>TZif</abbr> data.</li>
+href="https://tools.ietf.org/html/rfc5870">'geo' URI</a>.</li>
 <li>The <a href="https://tools.ietf.org/html/rfc5545">
 Internet Calendaring and Scheduling Core Object Specification
 (iCalendar)</a> (Internet <abbr>RFC</abbr> 5445)
diff --git a/tzfile.5 b/tzfile.5
index bbdccfc..2f70915 100644
--- a/tzfile.5
+++ b/tzfile.5
@@ -15,7 +15,8 @@ The timezone information files used by
 .BR tzset (3)
 are typically found under a directory with a name like
 .IR /usr/share/zoneinfo .
-These files begin with a 44-byte header containing the following fields:
+These files use the format described in Internet RFC 8536.
+The format begins with a 44-byte header containing the following fields:
 .IP * 2
 The magic four-byte ASCII sequence
 .q "TZif"
@@ -384,6 +385,15 @@ of one hour, or of 15 minutes, or of 1 minute.
 .BR tzset (3),
 .BR tzselect (8),
 .BR zdump (8),
-.BR zic (8)
+.BR zic (8).
+.PP
+Olson A, Eggert P, Murchison K. The Time Zone Information Format (TZif).
+2019 Feb.
+.UR https://\:www.rfc-editor.org/\:info/\:rfc8536
+Internet RFC 8536
+.UE
+.UR https://\:doi.org/\:10.17487/\:RFC8536
+doi:10.17487/RFC8536
+.UE .
 .\" This file is in the public domain, so clarified as of
 .\" 1996-06-05 by Arthur David Olson.
diff --git a/tzfile.h b/tzfile.h
index 27a38cc..446c8d5 100644
--- a/tzfile.h
+++ b/tzfile.h
@@ -33,6 +33,9 @@
 #define TZDEFRULES	"posixrules"
 #endif /* !defined TZDEFRULES */
 
+
+/* See Internet RFC 8536 for more details about the following format.  */
+
 /*
 ** Each file begins with. . .
 */
-- 
2.20.1

