mirror of
https://frontier.innolan.net/rainlance/amiga-tz.git
synced 2025-11-20 21:42:05 +00:00
468555e32d
Using '\-' to denote ASCII minus has problems in groff output, since it generates a minus sign in the current font, and if you cut and paste from the documentation the resulting text won't work. To avoid the problem, define a string \*- that expands to ASCII minus in a constant-width font in groff. Also, change some instances of \(mi and \(pl to use plain \- and +, since we no longer need special fonts for these. Finally, remove some no-longer-needed instances of "\^" after italicized words.
73 lines
2.0 KiB
Groff
73 lines
2.0 KiB
Groff
.TH ZDUMP 8
|
|
.SH NAME
|
|
zdump \- time zone dumper
|
|
.SH SYNOPSIS
|
|
.B zdump
|
|
[
|
|
.I option
|
|
\&... ] [
|
|
.I zonename
|
|
\&... ]
|
|
.SH DESCRIPTION
|
|
.ie \n(.g .ds - \f(CW-\fP
|
|
.el ds - \-
|
|
.I Zdump
|
|
prints the current time in each
|
|
.I zonename
|
|
named on the command line.
|
|
.PP
|
|
These options are available:
|
|
.TP
|
|
.BI "\*-\*-version"
|
|
Output version information and exit.
|
|
.TP
|
|
.B \*-v
|
|
For each
|
|
.I zonename
|
|
on the command line,
|
|
print the time at the lowest possible time value,
|
|
the time one day after the lowest possible time value,
|
|
the times both one second before and exactly at
|
|
each detected time discontinuity,
|
|
the time at one day less than the highest possible time value,
|
|
and the time at the highest possible time value,
|
|
Each line ends with
|
|
.B isdst=1
|
|
if the given time is Daylight Saving Time or
|
|
.B isdst=0
|
|
otherwise.
|
|
.TP
|
|
.B \*-V
|
|
Like
|
|
.BR \*-v ,
|
|
except omit the times relative to the extreme time values.
|
|
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).
|
|
By default,
|
|
the program cuts off verbose output near 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.
|
|
.SH LIMITATIONS
|
|
Time discontinuities are found by sampling the results returned by localtime
|
|
at twelve-hour intervals.
|
|
This works in all real-world cases;
|
|
one can construct artificial time zones for which this fails.
|
|
.PP
|
|
In the output, "UT" denotes the value returned by
|
|
.IR gmtime (3),
|
|
which uses UTC for modern time stamps and some other UT flavor for
|
|
time stamps that predate the introduction of UTC.
|
|
No attempt is currently made to have the output use "UTC" for newer
|
|
and "UT" for older time stamps,
|
|
partly because the exact date of the introduction of UTC is problematic.
|
|
.SH "SEE ALSO"
|
|
newctime(3), tzfile(5), zic(8)
|
|
.\" This file is in the public domain, so clarified as of
|
|
.\" 2009-05-17 by Arthur David Olson.
|