Skip to contentSkip to conversation

zdump(8): zdump -c has an opposite behavior, in my xterm: lower bound is inclusive ...

Bug 207345 Paul Eggert 2 participants 2 messages Apr 23, 2020 – Apr 24, 2020 2 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Paul Eggert

author
#2 lore raw
In reply to a message not in the archive

I installed the attached doc patch to tzdb try to clarify things. The documented zdump behavior is kind of weird, but now's not the time to change it as we're about to do a new tzdb release.

From d5f78a4326b94809e1cba6fcc4b59ba2a10b2d1c Mon Sep 17 00:00:00 2001
From: Paul Eggert <[email protected]>
Date: Thu, 23 Apr 2020 15:53:24 -0700
Subject: [PATCH] Clarify zdump -c

* zdump.8: Clarify -c cutoff timestamps.
Problem reported by Marco Curell via Michael Kerrisk; see:
https://bugzilla.kernel.org/show_bug.cgi?id=207345

---
 zdump.8 | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
zdump.8 +5 -5
index fb6b8df..98109ad 100644
@@ -74,11 +74,11 @@ implementations with different time representations.
 Cut off interval output at the given year(s).
 Cutoff times are computed using the proleptic Gregorian calendar with year 0
 and with Universal Time (UT) ignoring leap seconds.
-The lower bound is exclusive and the upper is inclusive; for example, a
-.I loyear
-of 1970 excludes a transition occurring at 1970-01-01 00:00:00 UTC but a
-.I hiyear
-of 1970 includes the transition.
+Cutoffs are at the start of each year, where the lower-bound
+timestamp is exclusive and the upper is inclusive; for example,
+.B "\*-c 1970,2070"
+selects transitions after 1970-01-01 00:00:00 UTC
+and on or before 2070-01-01 00:00:00 UTC.
 The default cutoff is
 .BR \*-500,2500 .
 .TP
Signature · 1 line
2.17.1
#3 lore raw
Quoted 4 lines · Paul Eggert

I installed the attached doc patch to tzdb try to clarify things. The documented zdump behavior is kind of weird, but now's not the time to change it as we're about to do a new tzdb release.

Thanks, Paul. If you wold be so nice as to drop me a note when the release is done, I will resync that pages in man-pages.

Thanks,

Michael

Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/