summaryrefslogtreecommitdiff
path: root/zic.8
Commit message (Collapse)AuthorAgeFilesLines
* Append tzdb arg 4 to .TH linesPaul Eggert2023-03-081-1/+1
| | | | | Suggested by Alejandro Colomar in: https://lore.kernel.org/linux-man/08a72d2c-e7cb-4390-2cb1-7601b344ce9e@gmail.com/T/#t
* Omit unnecessary hyphensPaul Eggert2023-03-071-1/+1
| | | | | This was motivated by a desire to sync better with the Linux man pages, which omitted an unnecessary hyphen in tzfile.5.
* Bring doc up-to-date with draft POSIXPaul Eggert2023-03-031-5/+8
| | | | | | | | | | | * Makefile, date.1, newctime.3, newtzset.3, theory.html: Don’t say settings like TZ='EST5EDT' are “nonstandard and obsolete”, as draft POSIX says they use implementation-defined DST rules. Clarify and strengthen the wording of the description of the now-obsolete POSIXRULES macro and posixrules file, the latter of which is still commonly installed even though it does not work. Improve doc for TZDEFRULESTRING. Give Morocco instead of Iran as an example of unusual DST, as Iran no longer observes DST.
* * zic.8: Work better with Solaris 10 troff.Paul Eggert2022-11-261-0/+1
|
* * zic.8: Port \(ha \(ga \(ti back to old troffPaul Eggert2022-11-251-3/+2
|
* * zic.8: Port \(aq back to old troff.Paul Eggert2022-11-251-1/+3
|
* Use CR font instead of CWPaul Eggert2022-11-251-1/+1
| | | | | Suggested by G Branden Robinson in: https://mm.icann.org/pipermail/tz/2022-November/032336.html
* Put public-domain notices at man page startsPaul Eggert2022-11-231-2/+2
| | | | Suggested by Alejandro Colomar.
* Use lower case page titles for commandsPaul Eggert2022-11-231-1/+1
| | | | | | From a suggestion by G. Branden Robinson via Alejandro Colmar in: https://lore.kernel.org/linux-man/20221123134827.10420-4-alx@kernel.org/T/#u * date.1, zdump.8, zic.8: Use lower case .TH arguments.
* zic.8: Use correct escape sequences instead of special charactersAlejandro Colomar2022-11-231-1/+1
| | | | | | | Reviewed-by: "G. Branden Robinson" <g.branden.robinson@gmail.com> Cc: Geoff Clare <gwc@opengroup.org> Cc: <groff@gnu.org> Signed-off-by: Alejandro Colomar <alx@kernel.org>
* zic now supports links to linksPaul Eggert2022-10-241-4/+25
| | | | | | | | | * NEWS, backward, zic.8: Mention this. * zic.c (make_links): New function, which supports links to later links. In this function, improve quality of warnings about links to links. (main): Use it.
* Port .txt generation to macOSPaul Eggert2022-08-101-2/+4
| | | | | | | | | | | | | | | Be able to build man pages on macOS, which has mandoc not nroff. Although mandoc has some minor glitches compared to nroff, it’s good enough. This follows up on a suggestion by Guy Harris in: https://mm.icann.org/pipermail/tz/2022-August/031786.html * time2posix.3: Insert \& to convince groff to not double-space afterwards, so that it doesn’t disagree with mandoc. * tzselect.8, zic.8: Use \& instead of \" because mandoc mishandles the latter. Don’t use a 5-deep nested .if on one line, as mandoc mishandles it. * workman.sh: If nroff and perl are not both available, then use mandoc and col if they are both available, else report an error.
* * zic.8: Don’t pagebreak just after "EXTENDED EXAMPLE".Paul Eggert2022-07-261-7/+7
|
* Fix minor glitches in .txt outputPaul Eggert2022-07-261-3/+11
|
* * zic.8: fix minus typoPaul Eggert2022-07-121-1/+1
|
* Add -R option to zicPaul Eggert2022-07-121-0/+11
| | | | | | | | | (Need suggested by Almaz Mingaleev.) * NEWS, zic.8: Document option. * zic.c (usage): Mention new option. (redundant_time): New static var. (redundant_time_option): New function. (main, writezone, outzone): Support -R.
* Document that zic -r doesn’t necessarily shrinkPaul Eggert2022-06-301-2/+9
| | | | * zic.8: Mention that -r can grow output.
* * zic.8: Say that STDOFF lacks suffix letters.Paul Eggert2022-05-131-1/+1
|
* zic now checks input bytes more carefullyPaul Eggert2022-04-011-1/+2
| | | | | | | | Also, it allows input lines up to 2048 bytes, which is the current POSIX minimum limit (the old was 512). * zic.c (_POSIX2_LINE_MAX): New macro, if not already defined. (inputline): New function. (infile): Prefer it to fgets. Buffer size is now _POSIX2_LINE_MAX.
* zic -r now uses -00 for unspecified timestampsPaul Eggert2021-10-151-1/+5
| | | | | | | | * NEWS, zic.8: Mention this. * zic.c (unspecifiedtype): New static var. (limitrange): Use unspecified time before -r low cutoff. (writezone): Use it after -r high cutoff. (outzone): Create unspecified time type if cutoffs are in use.
* Document that -00 means local time is unspecifiedPaul Eggert2021-10-111-0/+3
| | | | | * tzfile.5, zic.8: Document longstanding practice in time zone abbreviations. This better matches draft RFC 8536bis.
* Fix zic.8 typosPaul Eggert2021-10-081-2/+2
| | | | | * zic.8: Omit a stray “of” (thanks to Jonathan Wakely). Also, omit a stray “effect,”.
* Improve leap second table truncation docPaul Eggert2021-09-161-1/+1
| | | | | | | | | | | | | | * NEWS: Mention possible successor to RFC 8536, and relaxation on TZif reader’s restriction on gaps between leaps. * tzfile.5: Improve wording on leap second expiration. Specify correction before truncated leap second table more accurately, given how localtime.c behaves; for example, the first leap second is considered to be positive if and only if its correction is positive. Say what to do after leap second table expires. Add TZ="XXX3EDT4,0/0,J365/23" example. Say that positive leap seconds not at end of localtime minute have not been a practical problem yet. * tzfile.5, zic.8: Use \- (current font minus) instead of \(mi (math font minus).
* Document more background of rolling leap secondsPaul Eggert2021-09-131-3/+5
| | | | | * zic.8: It looks like rolling leaps were rarely used in broadcasts.
* Document background of rolling leap secondsPaul Eggert2021-09-131-2/+10
| | | | | | * zic.8: Give background for rolling leap seconds, adapted from email by Arthur David Olson in: https://mm.icann.org/pipermail/tz/2021-September/030368.html
* zic -r is incompatible with rolling leapsPaul Eggert2021-09-121-0/+3
| | | | | * NEWS, zic.8: Mention this. * zic.c (leapadd): Report an error if the user tries it.
* Use https: for opengroup in zic.8Paul Eggert2021-09-121-1/+1
|
* Fix leap second expiry and truncationPaul Eggert2021-03-161-14/+11
| | | | | | | | | | | | | | | * Makefile, NEWS, tzfile.5, zic.8: Document the change. * zic.c (ZIC_VERSION_PRE_2013, ZIC_VERSION, comment_leapexpires): Remove. All uses removed. (infile): Don’t bother parsing #expires lines any more; only Expires lines matter now. (struct timerange): New member leapexpiry. (limitrange, writezone): Set it. (writezone): If leap seconds are generated, append a no-op leap correction indicating when leap seconds expire. Generate version 4 files (with a warning if -v) if the leap second table is truncated from below, or expires. Fix bug if thisleapcnt changes after thisleaplim is set.
* No zic -L truncation due to leapseconds ExpiresmasterPaul Eggert2021-03-061-3/+0
| | | | | | | | Problem reported by Ian Abbott in: https://mm.icann.org/pipermail/tz/2021-March/029909.html * NEWS: Explain the situation. * zic.8: Remove note about truncation. * zic.c (adjleap): Do not truncate hi_time.
* Improve doc of zic coalescing zone+DST transitionsPaul Eggert2020-12-221-15/+21
| | | | | | | * zic.8: Improve documentation for how certain transitions are coalesced. Also, use current data for America/Menominee instead an America/Grand_Turk entry that not in current data. Improvements suggested by Tim Parenti.
* Document zic coalescing zone+DST transitionsPaul Eggert2020-12-071-0/+30
| | | | | | | | | * NEWS, zic.8: Document that zic coalesces transitions when a zone falls back just before DST springs forward. Document jump-back ambiguity * zic.8: Document avoidance of two nearly-simultanous transitions for Grand Turk.
* Drop support for zic -y, Rule TYPEs, pacificnewTim Parenti2020-10-031-9/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | These features have not been used by the distribution since release 2000f, were previously deprecated in 2015f, and zic has warned against their use since 2017c. * zic.c (struct rule): Remove r_yrtype field. (main): Ignore obsolete -y option. (rulesub): Error on nontrivial use of the former Rule TYPE field. (stringzone): Remove year type check. (outzone): Stop considering the former TYPE field when applying Rules. (shellquote, yearistype): Remove now-disused code. * zic.8: Rename TYPE field of Rule lines to "-" in examples and in the input format specification; fully deprecate this field for backwards compatibiilty only. * africa, antarctica, asia, australasia, backzone, europe, northamerica, southamerica, zoneinfo2tdf.pl: Rename TYPE field in Rule line header comments to "-". * pacificnew, yearistype.sh: Remove obsolete files. * tz-how-to.html: Rename TYPE field of Rule lines to "-" in examples; expand explanation of FROM and TO fields so that the reworked description of the deprecated field makes sense in context. * Makefile (YEARISTYPE, yearistype): Remove. (DATA, all, INSTALLARGS, INSTALL_DATA_DEPS, check_character_set, clean_misc): Remove dependencies on yearistype, yearistype.sh, and YEARISTYPE. (TDATA_TO_CHECK, VERSION_DEPS): Remove dependencies on obsolete files. * NEWS: Document this.
* zic now defaults to ‘-b slim’Paul Eggert2020-06-211-6/+4
| | | | | | | | | | Make zic’s ‘-b slim’ option the default. This option first appeared in tzdb 2019b (2019-07-01), and is already the default in NetBSD 9.0 (2020-02-14) and seems to be working there. Using slim format should help finish off the TZif format’s Y2038 transition that began in tzcode 95f (1995-10-28). * Makefile, NEWS, zic.8: Mention this. * zic.c (ZIC_BLOAT_DEFAULT): Default to "slim".
* zic has new ‘-l -’ and ‘-p -’ optionsPaul Eggert2020-06-131-0/+12
| | | | | * NEWS, zic.8: Mention this. * zic.c (dolink): If fromfield is "-", simply remove tofield.
* Use bold for command and func names in man pagesPaul Eggert2020-04-261-1/+1
| | | | | This seems to be the modern style. Problem reported by Michael Kerrisk (for GNU/Linux man pages).
* Define “UT” in man pagesPaul Eggert2020-04-211-1/+1
| | | | | * tzfile.5, zic.8: Define the abbreviation “UT” on its first use. (Problem reported by Helge Kreutzmann via Michael Kerrisk.)
* Add support for Expires lines to zicPaul Eggert2020-01-141-1/+40
| | | | | | | | | | | | | | | | | * Makefile (EXPIRES_LINE): New macro. (leapseconds): Use it. * NEWS, zic.8: Mention this. * leapseconds.awk: Also output an "Expires" line, but comment it out for now so that older zic implementations do not reject the generated leapseconds file. * zic.c (LC_EXPIRES, EXPIRES_FIELDS): New macros. (leapexpires): New static var. (leap_line_codes, infile, adjleap): Add support for expiration lines. (getleapdatetime): New function, with much of the former inleap implementation. (inleap): Use it. (inexpires): New function.
* 'zic -b slim' now omits isstd, isutPaul Eggert2019-06-181-1/+6
| | | | | | | | | | | | The new '-b slim' option of zic now omits the isstd and isut tables in TZif files. Because the intended use of these tables often fails in practice and has been deprecated, we might as well drop them when the user specifies the new '-b slim' option. This change does not affect zic's default behavior, and does not affect the behavior of ‘zic -b slim -p America/New_York’, so the old System V behavior still works even with -b slim. * Makefile, NEWS, zic.8: Adjust comments accordingly. * zic.c (addtype): Omit isstd and isut if '-b slim'.
* Deprecate ‘zic -p POSIXRULES’Paul Eggert2019-06-181-2/+5
| | | | | | | | | | | | | | | | | | | zic’s -p option was intended as a transition from historical System V code that treated TZ="XXXnYYY" as meaning US daylight-saving rules in a time zone n hours west of UT, with XXX abbreviating standard time and YYY abbreviating DST. zic -p allows the tzdata installer to specify (say) Europe/Brussels's rules instead of US rules. This behavior is not well documented and often fails in practice; for example it does not work with current glibc for contemporary timestamps, and it does not work in tzdb itself for timestamps after 2037. So, document it as being obsolete, with the intent that it will be removed in a future version. This change does not affect behavior of the default installation. * Makefile, NEWS, tzfile.5, zic.8: Adjust comments and documentation accordingly. * Makefile (install): Add support for empty POSIXRULES, which now means not to use zic -p when installing.
* Fix minor zic(8) formatting glitchesPaul Eggert2019-06-181-1/+6
| | | | | * zic.8: Fix tab alignment of Link lines. Work even on devices that cannot represent “7°26′22.50″”.
* More clarification/explanation from RFC 8536Paul Eggert2019-06-171-8/+8
| | | | | | | | | | | | | | | | | | | | | | This just changes documentation: it does not change code or data. Mostly, it just adopts more terminology from RFC 8536. It also contains an example of what the std/wall and UT/local indicators are for. * newtzset.3, theory.html, tz-how-to.html, tzfile.5, tzfile.h, zic.8: In documentation and comments, make it clearer that local time equals wall clock time. * tzfile.5, tzfile.h: In documentation and comments, say that when isut is 1, isstd must also be 1. * tzfile.5: Specify that bytes are 8 bits, that binary integers use two's complement, and that booleans use 0 and 1. Say that UT offsets are never equal to -2**31, and that they realistically are in the range [-89999, 93599]. Say that leap second counts are signed. Say why std/wall and UT/local indicators are present, and give AKST9AKDT as an example. Do not say that the first standard-time ttinfo is used by localtime, as the actual heuristic is far more complicated; instead, document what RFC 8536 says as what's normally used. * zic.c (struct rule): Adjust comments.
* Use STDOFF, not UTOFF, for standard timePaul Eggert2019-06-171-5/+5
| | | | | | | | | | | | | | * africa, antarctica, asia, australasia, backzone, europe, factory: * northamerica, pacificnew, southamerica, systemv, tz-how-to.html: * zic.8, zoneinfo2tdf.pl: Use STDOFF instead of UTOFF in comments. * zic.c (struct rule): Rename r_stdoff to r_save. (struct zone): Rename z_stdoff to z_save and z_utoff to z_stdoff. (ZF_STDOFF): Rename from ZF_UTOFF. (ZFC_STDOFF): Rename from ZFC_UTOFF. (RF_SAVE): Rename from RF_STDOFF. (getsave): Rename from getstdoff. (getsave, inzsub, doabbr, stringrule, outzone): Rename locals for consistency.
* New zic -b option to shrink data and test y2038Paul Eggert2019-06-131-9/+38
| | | | | | | | | | | | | | | | | * Makefile (ZFLAGS): Mention -b in comment. * NEWS: Mention this. * zic.c (usage): Mention -b. (bloat): New static var. (want_bloat): New static function. (main): Parse new -b option. (writezone): In slim output, suppress QTBUG-53071 workaround, pre-2011 bug workaround, all-zero isstdcnt and isutcnt indicators, and 32-bit data (except for header and the single type that RFC 8536 requires). (outzone): In slim output, suppress redundant transitions back to 1900 or forward through 2038, and suppress redundant transitions just before the TZ string takes over. * zic.8: Document -b. Sort options alphabetically.
* Assume zic 2004 or later in "Apr Sun>=25" etc.Paul Eggert2019-05-181-0/+9
| | | | | | | | * asia (Zion), northamerica (Toronto): Use constructs like "Apr Sun>=25" and "Apr Fri<=1" that have been supported by zic since 2004. Although Solaris 8 used pre-2004 zic, Solaris 8 reached end-of-life in March 2012. * zic.8: State more clearly that "Apr Sun>=25" is allowed.
* Bring zic man page up to datePaul Eggert2019-05-161-12/+48
| | | | | | | * zic.8: Don’t mention time(2), since zic does not rely on time_t any more. Mention other ways that -v generates warnings. ON fields can’t contain non-space white space characters either. Remove incorrect assertion that fractional seconds are not allowed.
* zic -r/@T is now exclusive, not inclusivePaul Eggert2019-03-151-4/+4
| | | | | | | | | | This is for consistency with RFC 8536 section 5.1 and RFC 7808 section 3.9. (Problem reported by Christopher Wong.) * zic.8: Document this. * zic.c (timerange_option): Subtract one from the specified upper bound before using it, unless the actual upper bound exceeded the maximum representable integer. Check more carefully for integer overflow and empty ranges.
* zic: new -r optionPaul Eggert2019-03-081-5/+24
| | | | | | | | | | | | | | | (Inspired by a feature request from Christopher Wong.) * Makefile (ZFLAGS), NEWS, zic.8, zic.c (usage): Mention it. * zic.8: Remove documentation for old -s option, which no longer was supported anyway. * zic.c (lo_time, hi_time): New static vars. (timerange_option): New function. (main): Use it to parse -r. (struct timerange): New type. (limitrange): New function. (writezone): Use it to support -r. (stringzone): Do not output a TZ string if the output is truncated on the high end; see Internet RFC
* Improve doc for rule interpretationPaul Eggert2019-01-191-2/+16
| | | | | | | | | This was inspired by Arthur David Olson’s explanation in: https://mm.icann.org/pipermail/tz/2019-January/027402.html * Makefile (POSIXRULES): Improve comments about rules. Remove now-obsolete comment about POSIX and New York. * zic.8: Give a ruleless TZ example. Add a "FILES" section header. Say that a zone or continuation line defaults to standard time.
* * zic.8: Clarify role of leap seconds in HH:MM:SS timestamps.Paul Eggert2018-10-221-0/+4
|
* * zic.8: Clarify 24-hour format.Paul Eggert2018-10-131-4/+5
|
View Lorry Controller Status