1
0
mirror of https://frontier.innolan.net/rainlance/amiga-tz.git synced 2025-11-23 17:51:19 +00:00

Revert the change that added meta-information to version-3 format.

Further testing found that it was incompatible with Ubuntu 12.04 glibc
so this feature requires redesign and more testing.
* Makefile (ZFLAGS): Remove comment about name and version info.
Make it an empty var instead.
* tzfile.5, tzfile.h: Remove description of meta-information.
* zic.8: Remove options -n and -o.
* zic.c: Don't include <stddef.h>.
(genoption, genoptions, genname, addgenoption, writevalue): Remove.
(usage, main, writezone): Remove support for -n and -o.
This commit is contained in:
Paul Eggert
2013-09-11 02:42:07 -07:00
parent 2022cddf08
commit a46793a95b
5 changed files with 7 additions and 104 deletions

View File

@ -134,43 +134,22 @@ For version-2-format time zone 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.
After the second header and data,
and just before the end of the file, comes a newline-enclosed,
After the second header and data comes a newline-enclosed,
POSIX-TZ-environment-variable-style string for use in handling instants
after the last transition time stored in the file
(with nothing between the newlines if there is no POSIX representation for
such instants).
.PP
Version-3-format time zone files have the following additions:
.IP
The POSIX-TZ-style string may use two minor extensions to the
POSIX TZ format, as described in
For version-3-format time zone 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
\(mi167 through 167 instead of the POSIX-required unsigned values
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.
.IP
The newline-enclosed POSIX-TZ-style string is preceded by a section
containing auxiliary meta-information that is not needed to process
time stamps. This section consists of another copy of the
newline-enclosed POSIX-TZ-style string (this is for the benefit of
version-2-only clients), followed by a four-byte integer size value,
followed by zero or more NUL-terminated byte strings, followed by an
additional NUL. The size value is the total number of bytes in all
the byte strings, including the trailing NULs at the end of the
strings, but not including the additional NUL. Each byte string
consists of a name-value pair separated by "=". Names consist of
ASCII letters, digits and underscores, and start with a letter;
duplicate names are not allowed. Two common names are "name", the
Zone name for the data, and "version", the data's version number.
Values can contain any bytes except NUL.
.PP
Future additions to the format may insert more data just before the
newline-enclosed POSIX-TZ-style string at the end of the file, so
clients should not assume that this string immediately follows
the auxiliary meta-information.
Future changes to the format may append more data.
.SH SEE ALSO
newctime(3), newtzset(3)
.\" This file is in the public domain, so clarified as of