diff options
Diffstat (limited to 'zic.8')
| -rw-r--r-- | zic.8 | 153 |
1 files changed, 80 insertions, 73 deletions
@@ -22,14 +22,8 @@ zic \- timezone compiler .el .ds < \(la .ie '\(ra'' .ds > > .el .ds > \(ra -.ie \n(.g \{\ -. ds : \: -. ds - \f(CR-\fP -.\} -.el \{\ -. ds : -. ds - \- -.\} +.ie \n(.g .ds : \: +.el .ds : . .ds d " degrees .ds m " minutes .ds s " seconds @@ -50,17 +44,17 @@ specified in this input. If a .I filename is -.q "\*-" , +.q "\-" , standard input is read. .SH OPTIONS .TP -.B "\*-\*-version" +.B "\-\-version" Output version information and exit. .TP -.B \*-\*-help +.B \-\-help Output short usage message and exit. .TP -.BI "\*-b " bloat +.BI "\-b " bloat Output backward-compatibility data as specified by .IR bloat . If @@ -81,14 +75,14 @@ The default is as software that mishandles 64-bit data typically mishandles timestamps after the year 2038 anyway. Also see the -.B \*-r +.B \-r option for another way to alter output size. .TP -.BI "\*-d " directory +.BI "\-d " directory Create time conversion information files in the named directory rather than in the standard directory named below. .TP -.BI "\*-l " timezone +.BI "\-l " timezone Use .I timezone as local time. @@ -102,19 +96,19 @@ Link \fItimezone\fP localtime If .I timezone is -.BR \*- , +.BR \- , any already-existing link is removed. .TP -.BI "\*-L " leapsecondfilename +.BI "\-L " leapsecondfilename Read leap second information from the file with the given name. If this option is not used, no leap second information appears in output files. .TP -.BI "\*-p " timezone +.BI "\-p " timezone Use .IR timezone 's rules when handling nonstandard -TZ strings like "EET\*-2EEST" that lack transition rules. +TZ strings like "EET\-2EEST" that lack transition rules. .B zic will act as if the input contained a link line of the form .sp @@ -124,21 +118,21 @@ Link \fItimezone\fP posixrules If .I timezone is -.q "\*-" +.q "\-" (the default), any already-existing link is removed. .sp Unless .I timezone is -.q "\*-" , +.q "\-" , this option is obsolete and poorly supported. Among other things it should not be used for timestamps after the year 2037, and it should not be combined with -.B "\*-b slim" +.B "\-b slim" if .IR timezone 's transitions are at standard time or Universal Time (UT) instead of local time. .TP -.BR "\*-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" +.BR "\-r " "[\fB@\fP\fIlo\fP][\fB/@\fP\fIhi\fP]" Limit the applicability of output files to timestamps in the range from .I lo @@ -152,17 +146,17 @@ are possibly signed decimal counts of seconds since the Epoch (1970-01-01 00:00:00 UTC). Omitted counts default to extreme values. The output files use UT offset 0 and abbreviation -.q "\*-00" +.q "\-00" in place of the omitted timestamp data. For example, -.q "zic \*-r @0" +.q "zic \-r @0" omits data intended for negative timestamps (i.e., before the Epoch), and -.q "zic \*-r @0/@2147483648" +.q "zic \-r @0/@2147483648" outputs data intended only for nonnegative timestamps that fit into 31-bit signed integers. On platforms with GNU .BR date , -.q "zic \*-r @$(date +%s)" +.q "zic \-r @$(date +%s)" omits data intended for past timestamps. Although this option typically reduces the output file's size, the size can increase due to the need to represent the timestamp range @@ -173,10 +167,10 @@ causes a TZif file to contain explicit entries for transitions rather than concisely representing them with a proleptic TZ string. Also see the -.B "\*-b slim" +.B "\-b slim" option for another way to shrink output size. .TP -.BI "\*-R @" hi +.BI "\-R @" hi Generate redundant trailing explicit transitions for timestamps that occur less than .I hi @@ -187,11 +181,11 @@ Although it accommodates nonstandard TZif readers that ignore the proleptic TZ string, it increases the size of the altered output files. .TP -.BI "\*-t " file +.BI "\-t " file When creating local time information, put the configuration link in the named file rather than in the standard location. .TP -.B \*-v +.B \-v Be more verbose, and complain about the following situations: .RS .PP @@ -259,10 +253,10 @@ before 1970 or after the start of 2038. The output contains a truncated leap second table, which can cause some older TZif readers to misbehave. This can occur if the -.B "\*-L" +.B "\-L" option is used, and either an Expires line is present or the -.B "\*-r" +.B "\-r" option is also used. .PP The output file contains more than 1200 transitions, @@ -276,13 +270,13 @@ POSIX requires at least 3, and requires implementations to support at least 6. .PP An output file name contains a byte that is not an ASCII letter, -.q "\*-" , +.q "\-" , .q "/" , or .q "_" ; or it contains a file name component that contains more than 14 bytes or that starts with -.q "\*-" . +.q "\-" . .RE .SH FILES Input files use the format described in this section; output files use @@ -301,7 +295,7 @@ 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 +.B \-v option. .PP Input lines are made up of fields. @@ -331,14 +325,14 @@ abbreviation must be unambiguous in context. A rule line has the form .nf .ti +2 -.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00w\0\0'u +\w'1:00d\0\0'u +.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00w\0\0'u +\w'1:00d\0\0'u .sp -Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S +Rule NAME FROM TO \- IN ON AT SAVE LETTER/S .sp For example: .ti +2 .sp -Rule US 1967 1973 \*- Apr lastSun 2:00w 1:00d D +Rule US 1967 1973 \- Apr lastSun 2:00w 1:00d D .sp .fi The fields that make up a rule line are: @@ -347,7 +341,7 @@ The fields that make up a rule line are: Gives the name of the rule set that contains this line. The name must start with a character that is neither an ASCII digit nor -.q \*- +.q \- nor .q + . To allow for future extensions, @@ -375,9 +369,9 @@ may be used to repeat the value of the .B FROM field. .TP -.B \*- +.B \- Is a reserved field and should always contain -.q \*- +.q \- for compatibility with older versions of .BR zic . It was previously known as the @@ -389,7 +383,15 @@ of years the rule would apply. .TP .B IN Names the month in which the rule takes effect. -Month names may be abbreviated. +Month names may be abbreviated as mentioned previously; +for example, January can appear as +.q January , +.q JANU +or +.q Ja , +but not as +.q j +which would be ambiguous with both June and July. .TP .B ON Gives the day on which the rule takes effect. @@ -412,7 +414,12 @@ or a weekday name preceded by .q "last" (e.g., .BR "lastSunday" ) -may be abbreviated or spelled out in full. +may be abbreviated as mentioned previously, +e.g., +.q Su +for Sunday and +.q lastsa +for the last Saturday. There must be no white space characters within the .B ON field. @@ -442,8 +449,8 @@ Recognized forms include: 15:00 3 PM, 15 hours after 00:00 24:00 end of day, 24 hours after 00:00 260:00 260 hours after 00:00 -\*-2:30 2.5 hours before 00:00 -\*- equivalent to 0 +\-2:30 2.5 hours before 00:00 +\- equivalent to 0 .fi .in .sp @@ -517,7 +524,7 @@ or .q "EDT" ) of time zone abbreviations to be used when this rule is in effect. If this field is -.q \*- , +.q \- , the variable part is null. .PP A zone line has the form @@ -564,7 +571,7 @@ field, giving the amount of time to be added to local standard time and whether the resulting time is standard or daylight saving. Standard time applies if this field is -.B \*- +.B \- or for timestamps occurring before any rule takes effect. When an amount of time is given, only the sum of standard time and this amount matters. @@ -600,9 +607,9 @@ To conform to POSIX, a time zone abbreviation should contain only alphanumeric ASCII characters, .q "+" and -.q "\*-". +.q "\-". By convention, the time zone abbreviation -.q "\*-00" +.q "\-00" is a placeholder that means local time is unspecified. .TP .B UNTIL @@ -661,25 +668,25 @@ For example: .ne 7 .nf .in +2 -.ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'2006\0\0'u +\w'\*-\0\0'u +\w'Oct\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u +.ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'2006\0\0'u +\w'\-\0\0'u +\w'Oct\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp -# Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S +# Rule NAME FROM TO \- IN ON AT SAVE LETTER/S Rule US 1967 2006 - Oct lastSun 2:00 0 S Rule US 1967 1973 - Apr lastSun 2:00 1:00 D .ta \w'# Zone\0\0'u +\w'America/Menominee\0\0'u +\w'STDOFF\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u # Zone NAME STDOFF RULES FORMAT [UNTIL] -Zone America/Menominee \*-5:00 \*- EST 1973 Apr 29 2:00 - \*-6:00 US C%sT +Zone America/Menominee \-5:00 \- EST 1973 Apr 29 2:00 + \-6:00 US C%sT .sp .in .fi Here, an incorrect reading would be there were two clock changes on 1973-04-29, -the first from 02:00 EST (\*-05) to 01:00 CST (\*-06), -and the second an hour later from 02:00 CST (\*-06) to 03:00 CDT (\*-05). +the first from 02:00 EST (\-05) to 01:00 CST (\-06), +and the second an hour later from 02:00 CST (\-06) to 03:00 CDT (\-05). However, .B zic -interprets this more sensibly as a single transition from 02:00 CST (\*-05) to -02:00 CDT (\*-05). +interprets this more sensibly as a single transition from 02:00 CST (\-05) to +02:00 CDT (\-05). .PP A link line has the form .sp @@ -718,7 +725,7 @@ For example: .ta \w'Zone\0\0'u +\w'Greenwich\0\0'u Link Greenwich G_M_T Link Etc/GMT Greenwich -Zone Etc/GMT\0\00\0\0\*-\0\0GMT +Zone Etc/GMT\0\00\0\0\-\0\0GMT .sp .in .fi @@ -759,7 +766,7 @@ should be .q "+" if a second was added or -.q "\*-" +.q "\-" if a second was skipped. The .B R/S @@ -783,7 +790,7 @@ rolling leap seconds can be useful in specialized applications like SMPTE timecodes that may prefer to put leap second discontinuities at the end of a local broadcast day. However, rolling leap seconds are not supported if the -.B \*-r +.B \-r option is used. .PP The expiration line, if present, has the form: @@ -814,23 +821,23 @@ Here is an extended example of input, intended to illustrate many of its features. .nf .in +2 -.ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\*-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u +.ta \w'# Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'\-\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u .sp -# Rule NAME FROM TO \*- IN ON AT SAVE LETTER/S -Rule Swiss 1941 1942 \*- May Mon>=1 1:00 1:00 S -Rule Swiss 1941 1942 \*- Oct Mon>=1 2:00 0 \*- +# Rule NAME FROM TO \- IN ON AT SAVE LETTER/S +Rule Swiss 1941 1942 \- May Mon>=1 1:00 1:00 S +Rule Swiss 1941 1942 \- Oct Mon>=1 2:00 0 \- .sp .5 -Rule EU 1977 1980 \*- Apr Sun>=1 1:00u 1:00 S -Rule EU 1977 only \*- Sep lastSun 1:00u 0 \*- -Rule EU 1978 only \*- Oct 1 1:00u 0 \*- -Rule EU 1979 1995 \*- Sep lastSun 1:00u 0 \*- -Rule EU 1981 max \*- Mar lastSun 1:00u 1:00 S -Rule EU 1996 max \*- Oct lastSun 1:00u 0 \*- +Rule EU 1977 1980 \- Apr Sun>=1 1:00u 1:00 S +Rule EU 1977 only \- Sep lastSun 1:00u 0 \- +Rule EU 1978 only \- Oct 1 1:00u 0 \- +Rule EU 1979 1995 \- Sep lastSun 1:00u 0 \- +Rule EU 1981 max \- Mar lastSun 1:00u 1:00 S +Rule EU 1996 max \- Oct lastSun 1:00u 0 \- .sp .ta \w'# Zone\0\0'u +\w'Europe/Zurich\0\0'u +\w'0:29:45.50\0\0'u +\w'RULES\0\0'u +\w'FORMAT\0\0'u # Zone NAME STDOFF RULES FORMAT [UNTIL] -Zone Europe/Zurich 0:34:08 \*- LMT 1853 Jul 16 - 0:29:45.50 \*- BMT 1894 Jun +Zone Europe/Zurich 0:34:08 \- LMT 1853 Jul 16 + 0:29:45.50 \- BMT 1894 Jun 1:00 Swiss CE%sT 1981 1:00 EU CE%sT .sp |