mirror of https://github.com/mkerrisk/man-pages
tzfile.5: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
72942d65ad
commit
2061865fb4
|
@ -7,7 +7,7 @@
|
|||
.\"
|
||||
.TH TZFILE 5 2017-08-04 "" "Linux Programmer's Manual"
|
||||
.SH NAME
|
||||
tzfile \- time zone information
|
||||
tzfile \- timezone information
|
||||
.SH DESCRIPTION
|
||||
.ie '\(lq'' .ds lq \&"\"
|
||||
.el .ds lq \(lq\"
|
||||
|
@ -16,7 +16,7 @@ tzfile \- time zone information
|
|||
.de q
|
||||
\\$3\*(lq\\$1\*(rq\\$2
|
||||
..
|
||||
The time zone information files used by
|
||||
The timezone information files used by
|
||||
.BR tzset (3)
|
||||
are typically found under a directory with a name like
|
||||
.IR /usr/share/zoneinfo .
|
||||
|
@ -24,7 +24,7 @@ These files begin with a 44-byte header containing the following fields:
|
|||
.IP * 2
|
||||
The magic four-byte ASCII sequence
|
||||
.q "TZif"
|
||||
identifies the file as a time zone information file.
|
||||
identifies the file as a timezone information file.
|
||||
.IP *
|
||||
A byte identifying the version of the file's format
|
||||
(as of 2017, either an ASCII NUL, or
|
||||
|
@ -59,7 +59,7 @@ The number of local time types for which data entries are stored
|
|||
in the file (must not be zero).
|
||||
.TP
|
||||
.I tzh_charcnt
|
||||
The number of bytes of time zone abbreviation strings
|
||||
The number of bytes of timezone abbreviation strings
|
||||
stored in the file.
|
||||
.RE
|
||||
.PP
|
||||
|
@ -111,7 +111,7 @@ should be set by
|
|||
.BR localtime (3)
|
||||
and
|
||||
.I tt_abbrind
|
||||
serves as an index into the array of time zone abbreviation bytes
|
||||
serves as an index into the array of timezone abbreviation bytes
|
||||
that follow the
|
||||
.I ttinfo
|
||||
structure(s) in the file.
|
||||
|
@ -134,15 +134,15 @@ transitions always separated by at least 28 days minus 1 second.
|
|||
standard/wall indicators, each stored as a one-byte value;
|
||||
they tell whether the transition times associated with local time types
|
||||
were specified as standard time or wall clock time,
|
||||
and are used when a time zone file is used in handling POSIX-style
|
||||
time zone environment variables.
|
||||
and are used when a timezone file is used in handling POSIX-style
|
||||
timezone environment variables.
|
||||
.IP *
|
||||
.I tzh_ttisgmtcnt
|
||||
UT/local indicators, each stored as a one-byte value;
|
||||
they tell whether the transition times associated with local time types
|
||||
were specified as UT or local time,
|
||||
and are used when a time zone file is used in handling POSIX-style
|
||||
time zone environment variables.
|
||||
and are used when a timezone file is used in handling POSIX-style
|
||||
timezone environment variables.
|
||||
.PP
|
||||
The
|
||||
.BR localtime (3)
|
||||
|
@ -158,7 +158,7 @@ if either
|
|||
is zero or the time argument is less than the first transition time recorded
|
||||
in the file.
|
||||
.SS Version 2 format
|
||||
For version-2-format time zone files,
|
||||
For version-2-format timezone files,
|
||||
the above header and data are followed by a second header and data,
|
||||
identical in format except that
|
||||
eight bytes are used for each transition time or leap second time.
|
||||
|
@ -176,12 +176,13 @@ type must specify a daylight-saving time abbreviated
|
|||
.q "WEST"
|
||||
that is one hour east of UT.
|
||||
.SS Version 3 format
|
||||
For version-3-format time zone files, the POSIX-TZ-style string may
|
||||
For version-3-format timezone files, the POSIX-TZ-style string may
|
||||
use two minor extensions to the POSIX TZ format, as described in
|
||||
.IR newtzset (3).
|
||||
First, the hours part of its transition times may be signed and range from
|
||||
\-167 through 167 instead of the POSIX-required unsigned values
|
||||
from 0 through 24. Second, DST is in effect all year if it starts
|
||||
from 0 through 24.
|
||||
Second, DST is in effect all year if it starts
|
||||
January 1 at 00:00 and ends December 31 at 24:00 plus the difference
|
||||
between daylight saving and standard time.
|
||||
.PP
|
||||
|
|
Loading…
Reference in New Issue