>From 14e7ab5f516290c91554c08947b546165f3844ed Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Thu, 10 Sep 2015 16:28:51 -0700 Subject: [PROPOSED PATCH] Clarify transition format in tzfile documentation Ambiguity reported by Bill Seymour in: http://mm.icann.org/pipermail/tz/2015-September/022646.html * NEWS, tzfile.5: Clarify that transitions indicate time period starts. --- NEWS | 6 ++++++ tzfile.5 | 6 ++++-- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/NEWS b/NEWS index 8cf9a9c..37f461f 100644 --- a/NEWS +++ b/NEWS @@ -18,6 +18,12 @@ Unreleased, experimental changes On platforms with tm_zone, strftime.c now assumes it is not NULL. This simplifies the code and is consistent with zdump.c. + Changes affecting documentation + + The tzfile man page now documents that transition times denote the + starts (not the ends) of the corresponding time periods. + (Ambiguity reported by Bill Seymour.) + Release 2015f - 2015-08-10 18:06:56 -0700 diff --git a/tzfile.5 b/tzfile.5 index 54a67c6..0f2b2ea 100644 --- a/tzfile.5 +++ b/tzfile.5 @@ -50,7 +50,8 @@ Next come .I tzh_timecnt one-byte unsigned integer values; each one tells which of the different types of local time types -described in the file is associated with the same-indexed transition time. +described in the file is associated with the time period +starting with the same-indexed transition time. These values serve as indices into an array of .I ttinfo structures (with @@ -99,7 +100,8 @@ the first value of each pair gives the time at which a leap second occurs; the second gives the .I total -number of leap seconds to be applied after the given time. +number of leap seconds to be applied during the time period +starting at the given time. The pairs of values are sorted in ascending order by time. .PP Then there are -- 2.1.4