* zic.8: Distinguish keywords from names, e.g., the latter need not be in English. Document some OS restrictions on file names. --- zic.8 | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-)
diff --git a/zic.8 b/zic.8 index 233c2eaf..fcdbb673 100644 --- a/zic.8 +++ b/zic.8 @@ -330,12 +330,8 @@ for the POSIX Portable Character Set (PPCS) .UE and the encoding's non-unibyte characters should consist entirely of -non-PPCS bytes. Non-PPCS characters typically occur only in comments: -although output file names and time zone abbreviations can contain -nearly any character, other software will work better if these are -limited to the restricted syntax described under the -.B \-v -option. +non-PPCS bytes. +Non-PPCS characters typically occur only in comments. .PP Input lines are made up of fields. Fields are separated from one another by one or more white space characters. @@ -350,15 +346,16 @@ Any line that is blank (after comment stripping) is ignored. Nonblank lines are expected to be of one of three types: rule lines, zone lines, and link lines. .PP -Names must be in English and are case insensitive. +Keywords are in English and are case insensitive. +They are not reserved words. They appear in several contexts, and include month and weekday names -and keywords such as +and other words such as .BR "maximum" , .BR "only" , .BR "Rolling" , and .BR "Zone" . -A name can be abbreviated by omitting all but an initial prefix; any +A keyword can be abbreviated by omitting all but an initial prefix; any abbreviation must be unambiguous in context. .PP A rule line has the form @@ -592,6 +589,20 @@ or .q ".." ; a file name component is a maximal substring that does not contain .q "/" . +Names can be further restricted by the operating system or file system. +Most systems reject a name +.IB A / B +if there is another name +.IR A , +some reject names differing only in case, +and some reject names containing special characters like +.q ":" +and +.q "\e" . +Other software will work better if names are +limited to the restricted syntax described under the +.B \-v +option. .TP .B STDOFF The amount of time to add to UT to get standard time, -- 2.55.0
