1
0
mirror of https://frontier.innolan.net/rainlance/amiga-tz.git synced 2025-11-24 01:53:19 +00:00

Document some longstanding unwritten guidelines.

These come from POSIX or similar platforms, or from the standard
'zic' implementation, but never got written down anywhere.
* Theory: Document other POSIX-inspired restrictions on names.
* zic.8 (DESCRIPTION): Document that zic's behavior is unspecified
if some names are duplicates.  Sometimes it complains, sometimes not.
This commit is contained in:
Paul Eggert
2013-09-03 16:51:22 -07:00
parent 33edc00168
commit f636932933
2 changed files with 11 additions and 2 deletions

10
Theory
View File

@ -299,15 +299,21 @@ Here are the general rules used for choosing location names,
in decreasing order of importance:
Use only valid POSIX file name components (i.e., the parts of
names other than '/'). Within a file name component,
names other than '/'). Do not use the file name
components '.' and '..'. Within a file name component,
use only ASCII letters, '.', '-' and '_'. Do not use
digits, as that might create an ambiguity with POSIX
TZ strings. A file name component must not exceed 14
characters or start with '-'. E.g., prefer 'Brunei'
to 'Bandar_Seri_Begawan'.
A name must not be empty, or contain '//', or start or end with '/'.
Do not use names that differ only in case. Although the reference
implementation is case-sensitive, some other implementations
implementation is case-sensitive, some other implementations
are not, and they would mishandle names differing only in case.
If one name A is an initial prefix of another name AB (ignoring case),
then B must not start with '/', as a regular file cannot have
the same name as a directory in POSIX. For example,
'America/New_York' precludes 'America/New_York/Bronx'.
Uninhabited regions like the North Pole and Bouvet Island
do not need locations, since local time is not defined there.
If all the clocks in a region have agreed since 1970,

3
zic.8
View File

@ -362,6 +362,9 @@ field is used as an alternate name for that zone.
.PP
Except for continuation lines,
lines may appear in any order in the input.
However, the behavior is unspecified if multiple zone or link lines
define the same name, or if the source of one link line is the target
of another.
.PP
Lines in the file that describes leap seconds have the following form:
.nf