Return to zic.8 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / etc / tzone

Annotation of 43BSDTahoe/etc/tzone/zic.8, revision 1.1

1.1     ! root        1: .TH ZIC 8
        !             2: .SH NAME
        !             3: zic \- time zone compiler
        !             4: .SH SYNOPSIS
        !             5: .B zic
        !             6: [
        !             7: .B \-v
        !             8: ] [
        !             9: .B \-d
        !            10: .I directory
        !            11: ] [
        !            12: .B \-l
        !            13: .I localtime
        !            14: ] [
        !            15: .I filename
        !            16: \&... ]
        !            17: .SH DESCRIPTION
        !            18: .I Zic
        !            19: reads text from the file(s) named on the command line
        !            20: and creates the time conversion information files specified in this input.
        !            21: If a
        !            22: .I filename
        !            23: is
        !            24: .BR \- ,
        !            25: the standard input is read.
        !            26: .PP
        !            27: These options are available:
        !            28: .TP
        !            29: .BI "\-d " directory
        !            30: Create time conversion information files in the named directory rather than
        !            31: in the standard directory named below.
        !            32: .TP
        !            33: .BI "\-l " timezone
        !            34: Use the given time zone as local time.
        !            35: .I Zic
        !            36: will act as if the file contained a link line of the form
        !            37: .sp
        !            38: .ti +.5i
        !            39: Link   \fItimezone\fP          localtime
        !            40: .TP
        !            41: .B \-v
        !            42: Complain if a year that appears in a data file is outside the range
        !            43: of years representable by
        !            44: .IR time (2)
        !            45: values.
        !            46: .sp
        !            47: Input lines are made up of fields.
        !            48: Fields are separated from one another by any number of white space characters.
        !            49: Leading and trailing white space on input lines is ignored.
        !            50: An unquoted sharp character (#) in the input introduces a comment which extends
        !            51: to the end of the line the sharp character appears on.
        !            52: White space characters and sharp characters may be enclosed in double quotes
        !            53: (") if they're to be used as part of a field.
        !            54: Any line that is blank (after comment stripping) is ignored.
        !            55: Non-blank lines are expected to be of one of three types:
        !            56: rule lines, zone lines, and link lines.
        !            57: .PP
        !            58: A rule line has the form
        !            59: .nf
        !            60: .B
        !            61: .ti +.5i
        !            62: .ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
        !            63: .sp
        !            64: Rule   NAME    FROM    TO      TYPE    IN      ON      AT      SAVE    LETTER/S
        !            65: .sp
        !            66: For example:
        !            67: .ti +.5i
        !            68: .sp
        !            69: Rule   USA     1969    1973    \-      Apr     lastSun 2:00    1:00    D
        !            70: .sp
        !            71: .fi
        !            72: The fields that make up a rule line are:
        !            73: .TP "\w'LETTER/S'u"
        !            74: .B NAME
        !            75: Gives the (arbitrary) name of the set of rules this rule is part of.
        !            76: .TP
        !            77: .B FROM
        !            78: Gives the first year in which the rule applies.
        !            79: The word
        !            80: .B minimum
        !            81: (or an abbreviation) means the minimum year with a representable time value.
        !            82: The word
        !            83: .B maximum
        !            84: (or an abbreviation) means the maximum year with a representable time value.
        !            85: .TP
        !            86: .B TO
        !            87: Gives the final year in which the rule applies.
        !            88: In addition to
        !            89: .B minimum
        !            90: and
        !            91: .B maximum
        !            92: (as above),
        !            93: the word
        !            94: .B only
        !            95: (or an abbreviation)
        !            96: may be used to repeat the value of the
        !            97: .B FROM
        !            98: field.
        !            99: .TP
        !           100: .B TYPE
        !           101: Gives the type of year in which the rule applies.
        !           102: If
        !           103: .B TYPE
        !           104: is
        !           105: .B \-
        !           106: then the rule applies in all years between
        !           107: .B FROM
        !           108: and
        !           109: .B TO
        !           110: inclusive;
        !           111: if
        !           112: .B TYPE
        !           113: is
        !           114: .BR uspres ,
        !           115: the rule applies in U.S. Presidential election years;
        !           116: if
        !           117: .B TYPE
        !           118: is
        !           119: .BR nonpres ,
        !           120: the rule applies in years other than U.S. Presidential election years.
        !           121: If
        !           122: .B TYPE
        !           123: is something else, then
        !           124: .I zic
        !           125: executes the command
        !           126: .ti +.5i
        !           127: \fByearistype\fP \fIyear\fP \fItype\fP
        !           128: .br
        !           129: to check the type of a year:
        !           130: an exit status of zero is taken to mean that the year is of the given type;
        !           131: an exit status of one is taken to mean that the year is not of the given type.
        !           132: .TP
        !           133: .B IN
        !           134: Names the month in which the rule takes effect.
        !           135: Month names may be abbreviated.
        !           136: .TP
        !           137: .B ON
        !           138: Gives the day on which the rule takes effect.
        !           139: Recognized forms include:
        !           140: .nf
        !           141: .in +.5i
        !           142: .sp
        !           143: .ta \w'Sun<=25\0\0'u
        !           144: 5      the fifth of the month
        !           145: lastSun        the last Sunday in the month
        !           146: lastMon        the last Monday in the month
        !           147: Sun>=8 first Sunday on or after the eighth
        !           148: Sun<=25        last Sunday on or before the 25th
        !           149: .fi
        !           150: .in -.5i
        !           151: .sp
        !           152: Names of days of the week may be abbreviated or spelled out in full.
        !           153: Note that there must be no spaces within the
        !           154: .B ON
        !           155: field.
        !           156: .TP
        !           157: .B AT
        !           158: Gives the time of day at which the rule takes effect.
        !           159: Recognized forms include:
        !           160: .nf
        !           161: .in +.5i
        !           162: .sp
        !           163: .ta \w'1:28:13\0\0'u
        !           164: 2      time in hours
        !           165: 2:00   time in hours and minutes
        !           166: 15:00  24-hour format time (for times after noon)
        !           167: 1:28:14        time in hours, minutes, and seconds
        !           168: .fi
        !           169: .in -.5i
        !           170: .sp
        !           171: Any of these forms may be followed by the letter
        !           172: .B w
        !           173: if the given time is local ``wall clock'' time or
        !           174: .B s
        !           175: if the given time is local ``standard'' time; in the absence of
        !           176: .B w
        !           177: or
        !           178: .BR s ,
        !           179: wall clock time is assumed.
        !           180: .TP
        !           181: .B SAVE
        !           182: Gives the amount of time to be added to local standard time when the rule is in
        !           183: effect.
        !           184: This field has the same format as the
        !           185: .B AT
        !           186: field
        !           187: (although, of course, the
        !           188: .B w
        !           189: and
        !           190: .B s
        !           191: suffixes are not used).
        !           192: .TP
        !           193: .B LETTER/S
        !           194: Gives the ``variable part'' (for example, the ``S'' or ``D'' in ``EST''
        !           195: or ``EDT'') of time zone abbreviations to be used when this rule is in effect.
        !           196: If this field is
        !           197: .BR \- ,
        !           198: the variable part is null.
        !           199: .PP
        !           200: A zone line has the form
        !           201: .sp
        !           202: .nf
        !           203: .ti +.5i
        !           204: .ta \w'Zone\0\0'u +\w'Australia/South\-west\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
        !           205: Zone   NAME    GMTOFF  RULES/SAVE      FORMAT  [UNTIL]
        !           206: .sp
        !           207: For example:
        !           208: .sp
        !           209: .ti +.5i
        !           210: Zone   Australia/South\-west   9:30    Aus     CST     1987 Mar 15 2:00
        !           211: .sp
        !           212: .fi
        !           213: The fields that make up a zone line are:
        !           214: .TP "\w'GMTOFF'u"
        !           215: .B NAME
        !           216: The name of the time zone.
        !           217: This is the name used in creating the time conversion information file for the
        !           218: zone.
        !           219: .TP
        !           220: .B GMTOFF
        !           221: The amount of time to add to GMT to get standard time in this zone.
        !           222: This field has the same format as the
        !           223: .B AT
        !           224: and
        !           225: .B SAVE
        !           226: fields of rule lines;
        !           227: begin the field with a minus sign if time must be subtracted from GMT.
        !           228: .TP
        !           229: .B RULES/SAVE
        !           230: The name of the rule(s) that apply in the time zone or,
        !           231: alternately, an amount of time to add to local standard time.
        !           232: If this field is
        !           233: .B \-
        !           234: then standard time always applies in the time zone.
        !           235: .TP
        !           236: .B FORMAT
        !           237: The format for time zone abbreviations in this time zone.
        !           238: The pair of characters
        !           239: .B %s
        !           240: is used to show where the ``variable part'' of the time zone abbreviation goes.
        !           241: .B UNTIL
        !           242: The time at which the GMT offset or the rule(s) change for a location.
        !           243: It is specified as a year, a month, a day, and a time of day.
        !           244: If this is specified,
        !           245: the time zone information is generated from the given GMT offset
        !           246: and rule change until the time specified.
        !           247: .IP
        !           248: The next line must be a
        !           249: ``continuation'' line; this has the same form as a zone line except that the
        !           250: string ``Zone'' and the name are omitted, as the continuation line will
        !           251: place information starting at the time specified as the
        !           252: .B UNTIL
        !           253: field in the previous line in the file used by the previous line.
        !           254: Continuation lines may contain an
        !           255: .B UNTIL
        !           256: field, just as zone lines do, indicating that the next line is a further
        !           257: continuation.
        !           258: .PP
        !           259: A link line has the form
        !           260: .sp
        !           261: .nf
        !           262: .ti +.5i
        !           263: .if t .ta \w'Link\0\0'u +\w'LINK-FROM\0\0'u
        !           264: .if n .ta \w'Link\0\0'u +\w'US/Eastern\0\0'u
        !           265: Link   LINK-FROM       LINK-TO
        !           266: .sp
        !           267: For example:
        !           268: .sp
        !           269: .ti +.5i
        !           270: Link   US/Eastern      EST5EDT
        !           271: .sp
        !           272: .fi
        !           273: The
        !           274: .B LINK-FROM
        !           275: field should appear as the
        !           276: .B NAME
        !           277: field in some zone line;
        !           278: the
        !           279: .B LINK-TO
        !           280: field is used as an alternate name for that zone.
        !           281: .PP
        !           282: Except for continuation lines,
        !           283: lines may appear in any order in the input.
        !           284: .SH NOTE
        !           285: For areas with more than two types of local time,
        !           286: you may need to use local standard time in the
        !           287: .B AT
        !           288: field of the earliest transition time's rule to ensure that
        !           289: the earliest transition time recorded in the compiled file is correct.
        !           290: .SH FILES
        !           291: /etc/zoneinfo  standard directory used for created files
        !           292: .SH "SEE ALSO"
        !           293: newctime(3), tzfile(5), zdump(8)
        !           294: .. @(#)zic.8   3.1

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.