[tz] zdump bug in Asia/Singapore

Paul Eggert eggert at cs.ucla.edu
Sun Sep 7 00:43:54 UTC 2014


Arthur David Olson wrote:
> We may save some grief down the line by specifying in zdump.8 that cutoffs
> are starts of UT years (as distinct from starts of local time years).

Yes, I suppose you're right.  Proposed patch attached.
-------------- next part --------------
From fef27b6086b22784e44281bfb3ec712cf258af65 Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert at cs.ucla.edu>
Date: Sat, 6 Sep 2014 17:42:00 -0700
Subject: [PROPOSED PATCH] * zdump.8, NEWS: Document zdump -c's treatment of
 years better.

(Problem reported by Arthur David Olson.)
---
 NEWS    | 6 ++++++
 zdump.8 | 9 ++++++---
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/NEWS b/NEWS
index 6955f70..53ec202 100644
--- a/NEWS
+++ b/NEWS
@@ -23,6 +23,12 @@ Unreleased, experimental changes
     An access to uninitalized data has been fixed.
     (Thanks to Jörg Richter for reporting the problem.)
 
+  Changes affecting documentation and commentary
+
+    zdump -c's treatment of years is now documented to use the
+    Gregorian calendar and Universal Time without leap seconds.
+    (Thanks to Arthur David Olson for reporting the problem.)
+
 
 Release 2014g - 2014-08-28 12:31:23 -0700
 
diff --git a/zdump.8 b/zdump.8
index 94de021..7f0bc78 100644
--- a/zdump.8
+++ b/zdump.8
@@ -45,14 +45,17 @@ This generates output that is easier to compare to that of
 implementations with different time representations.
 .TP
 .BI "\*-c " [loyear,]hiyear
-Cut off verbose output near the start of the given year(s).
+Cut off verbose output at the start of the given year(s).
+Cutoff times are computed using the Gregorian calendar and Universal
+Time (UT) ignoring leap seconds.
 By default,
-the program cuts off verbose output near the starts of the years
+the program cuts off verbose output at the starts of the years
 \-500 and 2500.
 .TP
 .BI "\*-t " [lotime,]hitime
 Cut off verbose output at the start of the given time(s),
-given in decimal seconds since 1970-01-01 00:00:00 UTC.
+given in decimal seconds since 1970-01-01 00:00:00
+Coordinated Universal Time (UTC).
 .SH LIMITATIONS
 Time discontinuities are found by sampling the results returned by localtime
 at twelve-hour intervals.
-- 
1.9.1


More information about the tz mailing list