From dca171f57aa35b53780cd16caa43bcdb0d4a1b40 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Sun, 13 May 2018 14:05:04 -0700 Subject: [PROPOSED 1/4] Constrain Rule names * NEWS: Mention this. * zic.8 (DESCRIPTION): Say that Rule names must start with a character that is neither "-" nor "+" nor a digit; this avoids ambiguity with integer offsets and disallows empty names. Say also that unquoted names should not contain !$%&'()*,/:;<=>?@[\]^`{|}~ to allow for future extensions. (Possibility of future extensions noted by Tom Lane.) --- NEWS | 8 ++++++++ zic.8 | 10 +++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index 05db756..56adc24 100644 --- a/NEWS +++ b/NEWS @@ -17,6 +17,14 @@ Unreleased, experimental changes observed DST in 1942/79, not 1961/80, and there were several errors for transition times and dates. (Thanks to P Chan.) + Changes to documentation + + New restrictions: A Rule name must start with a character that + is neither an ASCII digit nor "-" nor "+", and an unquoted name + should not use characters in the set "!$%&'()*,/:;<=>?@[\]^`{|}~". + The latter restriction makes room for future extensions (a + possibility noted by Tom Lane). + Changes to build procedure New 'make' target 'rearguard_tarballs' to build the rearguard diff --git a/zic.8 b/zic.8 index d105b24..5494efb 100644 --- a/zic.8 +++ b/zic.8 @@ -178,7 +178,15 @@ Rule US 1967 1973 \*- Apr lastSun 2:00s 1:00d D The fields that make up a rule line are: .TP "\w'LETTER/S'u" .B NAME -Gives the (arbitrary) name of the set of rules this rule is part of. +Gives the name of the set of rules this rule is part of. +The name must start with a character that is neither +an ASCII digit nor +.q \*- +nor +.q + . +To allow for future extensions, +an unquoted name should not contain characters from the set +.q !$%&'()*,/:;<=>?@[\e]^`{|}~ . .TP .B FROM Gives the first year in which the rule applies. -- 2.7.4