Linux-man Archive on lore.kernel.org
 help / color / Atom feed
* Re: [Bug 207345] zdump(8): zdump -c has an opposite behavior, in my xterm: lower bound is inclusive ...
       [not found] ` <bug-207345-197507-BrfGWbbBGi@https.bugzilla.kernel.org/>
@ 2020-04-23 22:57   ` Paul Eggert
  2020-04-24 14:15     ` Michael Kerrisk (man-pages)
  0 siblings, 1 reply; 2+ messages in thread
From: Paul Eggert @ 2020-04-23 22:57 UTC (permalink / raw)
  To: bugzilla-daemon
  Cc: Marco Curreli, Michael Kerrisk (man-pages),
	linux-man, Time zone mailing list


[-- Attachment #1: Type: text/plain, Size: 191 bytes --]

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.

[-- Attachment #2: 0001-Clarify-zdump-c.patch --]
[-- Type: text/x-patch, Size: 1257 bytes --]

From d5f78a4326b94809e1cba6fcc4b59ba2a10b2d1c Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
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(-)

diff --git a/zdump.8 b/zdump.8
index fb6b8df..98109ad 100644
--- a/zdump.8
+++ b/zdump.8
@@ -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
-- 
2.17.1


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [Bug 207345] zdump(8): zdump -c has an opposite behavior, in my xterm: lower bound is inclusive ...
  2020-04-23 22:57   ` [Bug 207345] zdump(8): zdump -c has an opposite behavior, in my xterm: lower bound is inclusive Paul Eggert
@ 2020-04-24 14:15     ` Michael Kerrisk (man-pages)
  0 siblings, 0 replies; 2+ messages in thread
From: Michael Kerrisk (man-pages) @ 2020-04-24 14:15 UTC (permalink / raw)
  To: Paul Eggert
  Cc: bugzilla-daemon, Marco Curreli, linux-man, Time zone mailing list

On Fri, 24 Apr 2020 at 00:57, Paul Eggert <eggert@cs.ucla.edu> wrote:
>
> 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

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

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, back to index

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <bug-207345-197507@https.bugzilla.kernel.org/>
     [not found] ` <bug-207345-197507-BrfGWbbBGi@https.bugzilla.kernel.org/>
2020-04-23 22:57   ` [Bug 207345] zdump(8): zdump -c has an opposite behavior, in my xterm: lower bound is inclusive Paul Eggert
2020-04-24 14:15     ` Michael Kerrisk (man-pages)

Linux-man Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-man/0 linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ https://lore.kernel.org/linux-man \
		linux-man@vger.kernel.org
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-man


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git