>From 8973320770f676c249229c5c4ca402057e7ec098 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Mon, 8 Sep 2014 12:24:35 -0700 Subject: [PROPOSED PATCH] * zdump.8, NEWS: Document zdump cutoff behavior more precisely. (Thanks to Tim Parenti for reporting the problem.) --- NEWS | 5 +++-- zdump.8 | 24 +++++++++++++++++------- 2 files changed, 20 insertions(+), 9 deletions(-) diff --git a/NEWS b/NEWS index 3134648..b786be6 100644 --- a/NEWS +++ b/NEWS @@ -30,8 +30,9 @@ Unreleased, experimental changes 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.) + Gregorian calendar and Universal Time without leap seconds, + and its behavior at cutoff boundaries is now documented better. + (Thanks to Arthur David Olson and Tim Parenti for reporting the problems.) Fractional-second GMT offsets have been documented for civil time in 19th-century Chennai, Jakarta, and New York. diff --git a/zdump.8 b/zdump.8 index 7f0bc78..c4b92b0 100644 --- a/zdump.8 +++ b/zdump.8 @@ -45,17 +45,27 @@ 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 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 at the starts of the years -\-500 and 2500. +Cut off verbose output at the given year(s). +Cutoff times are computed using the Gregorian calendar with year 0 +and with Universal Time (UT) ignoring leap seconds. +The lower bound is inclusive and the upper is exclusive; for example, a +.I loyear +of 1970 includes a transition occurring at the very start of 1970 but a +.I hiyear +of 1970 excludes the transition. +The default cutoff is +.BR \*-500,2500 . .TP .BI "\*-t " [lotime,]hitime -Cut off verbose output at the start of the given time(s), +Cut off verbose output at the given time(s), given in decimal seconds since 1970-01-01 00:00:00 Coordinated Universal Time (UTC). +The +.I zonename +determines whether the count includes leap seconds. +As with +.BR \*-c , +the cutoff's lower bound is inclusive and its upper bound is exclusive. .SH LIMITATIONS Time discontinuities are found by sampling the results returned by localtime at twelve-hour intervals. -- 1.9.3