-
-
Notifications
You must be signed in to change notification settings - Fork 93
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Squashed 'tz/' changes from d2c79c4bc..e6150f292
95ecc37d2 Release 2022a d90452ece * NEWS: Add 2022a "Briefly". 44b73f770 * NEWS: Coalesce Palestine entries. 049044d77 * zdump.c: Fix date typo in comment. e8681e760 Adjust Chile LMT; expand 1946/1947 commentary 0caefb646 Revert "Chile’s Magallanes was like Santiago in 1946/7" 22a2dca72 URL housekeeping 6d6a21f59 Chile’s Magallanes was like Santiago in 1946/7 f4b156691 Palestine springs forward a day later cac76bf92 Fix white space. 318759658 Add URLs to Morocco commentary (thanks to Milamber) 6ff7b3502 Fix French typo 88d2c3909 Fix Lubumbashi between 1897 and 1929 7f60edb1d * private.h (UNINIT_TRAP): Add comment. db9347fbb Fix processing of TZif truncation df4699ddf Add comments on Russia in 1981 (thanks to Alois Treindl) 4117b20d0 Simplify Ukraine metadata 93dcac0c6 Ukraine’s 1992/1996 DST changes 02:00s not 01:00u b74f54452 dumptime’s argument is always nonnull now 3a11c9cc2 I18nize zdump a bit better a12823400 Improve doc for some source files 0b8077257 Simplify recent zdump port 80096e016 zdump ports better to odd C11 platforms b6f92f762 zdump -v reports localtime+gmtime failures better e3c58df90 * Makefile (AWK): Warn re mawk 1.3.3 (thanks to Jonathan Ben Avraham) 9c8cb5d76 No leap second on 2022-06-30 cec7d9e2e Improve rearguard port of post-2087 Morocco 01eeac6b0 zic: omit parens that the C standard doesn’t allow 6cfaa796e Fix "el ds" typo in man pages aa9c4662f * CONTRIBUTING: Move pull request insns to start. 4292b9320 Convert CONTRIBUTING back to plain text b0c24fad4 Rename CONTRIBUTING.md back to CONTRIBUTING 7a200f2b3 Fix Y2242 bug in tzdb tarball generation 5f6467141 Support busybox awk 8407d785a Port zic to Solaris 10 automounts b10ff6d60 Port tzselect to Solaris 10 /bin/sh e4a46da99 Simplify tzselect by omitting old Bash workaround ee44afb40 Distribute tarballs in ustar rather than gnu form 68b99887d Remove duplicate Trinidad and Tobago comment f6c9f51fa Fix minor formatting inconsistencies 3fdd3c482 Rename CONTRIBUTING to CONTRIBUTING.md b0de1570e Switch to Markdown format 228a93f75 Remove bad backzone link for US Virgin Is 8b409e22d Be more generous when dealing with v1 data e5a4add00 Fix uninitialized variable bug 1a4a7eab6 spelling fix 0b13c6b41 Update Palestine commentary 59467e337 Improve Palestine predictions for 2025 and later b102002e5 Release 2021e d86edaf12 Palestine falls back October 29 01:00. 8da2e33e0 Palestine falls back October 28 24:00 4de3d7f24 Release 2021d 951b4f301 * NEWS: Reformat to fit in fewer columns. 5f06f9a31 zic -r now uses -00 for unspecified timestamps f8c660ce6 Simplify zic writezone slightly bdeb83438 Document that -00 means local time is unspecified f74940d96 Fiji suspends DST for the 2021/2022 season 0bf5a761f Fix zic.8 typos 868ba546b Correct spelling of "Treindl" (thanks to Steffen Nurpmeso) e5d72c0f9 Clarify comments re Rome in April 1944 git-subtree-dir: tz git-subtree-split: e6150f292f19c33ae136f70464d6075c41a1a5f3
- Loading branch information
Showing
28 changed files
with
511 additions
and
211 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,53 +1,58 @@ | ||
Contributing to the tz code and data | ||
# Contributing to the tz code and data | ||
|
||
Please do not create issues or pull requests on GitHub, as the | ||
proper procedure for proposing and distributing patches is via | ||
email as described below. | ||
|
||
The time zone database is by no means authoritative: governments | ||
change timekeeping rules erratically and sometimes with little | ||
warning, the data entries do not cover all of civil time before | ||
1970, and undoubtedly errors remain in the code and data. Feel | ||
free to fill gaps or fix mistakes, and please email improvements | ||
to [email protected] for use in the future. In your email, please give | ||
to <[email protected]> for use in the future. In your email, please give | ||
reliable sources that reviewers can check. | ||
|
||
----- | ||
|
||
Developers can contribute technical changes to the source code and | ||
data as follows. | ||
## Contributing technical changes | ||
|
||
To email small changes, please run a POSIX shell command like | ||
'diff -u old/europe new/europe >myfix.patch', and attach | ||
myfix.patch to the email. | ||
'myfix.patch' to the email. | ||
|
||
For more-elaborate or possibly-controversial changes, | ||
such as renaming, adding or removing zones, please read | ||
<https://www.iana.org/time-zones/repository/theory.html> or the file | ||
theory.html. It is also good to browse the mailing list archives | ||
"Theory and pragmatics of the tz code and data" | ||
<https://www.iana.org/time-zones/repository/theory.html>. | ||
It is also good to browse the mailing list archives | ||
<https://mm.icann.org/pipermail/tz/> for examples of patches that tend | ||
to work well. Additions to data should contain commentary citing | ||
reliable sources as justification. Citations should use https: URLs | ||
reliable sources as justification. Citations should use "https:" URLs | ||
if available. | ||
|
||
For changes that fix sensitive security-related bugs, please see the | ||
file SECURITY. | ||
distribution's 'SECURITY' file. | ||
|
||
Please submit changes against either the latest release in | ||
Please submit changes against either the latest release | ||
<https://www.iana.org/time-zones> or the main branch of the development | ||
repository. The latter is preferred. If you use Git the following | ||
workflow may be helpful: | ||
repository. The latter is preferred. | ||
|
||
## Sample Git workflow for developing contributions | ||
|
||
If you use Git the following workflow may be helpful: | ||
|
||
* Copy the development repository. | ||
|
||
git clone https://github.com/eggert/tz.git | ||
cd tz | ||
git clone https://github.com/eggert/tz.git | ||
cd tz | ||
|
||
* Get current with the main branch. | ||
|
||
git checkout main | ||
git pull | ||
git checkout main | ||
git pull | ||
|
||
* Switch to a new branch for the changes. Choose a different | ||
branch name for each change set. | ||
|
||
git checkout -b mybranch | ||
git checkout -b mybranch | ||
|
||
* Sleuth by using 'git blame'. For example, when fixing data for | ||
Africa/Sao_Tome, if the command 'git blame africa' outputs a line | ||
|
@@ -60,36 +65,33 @@ workflow may be helpful: | |
|
||
* Debug the changes, e.g.: | ||
|
||
make check | ||
make install | ||
./zdump -v America/Los_Angeles | ||
make check | ||
make install | ||
./zdump -v America/Los_Angeles | ||
|
||
* For each separable change, commit it in the new branch, e.g.: | ||
|
||
git add northamerica | ||
git commit | ||
git add northamerica | ||
git commit | ||
|
||
See recent 'git log' output for the commit-message style. | ||
|
||
* Create patch files 0001-*, 0002-*, ... | ||
* Create patch files 0001-..., 0002-..., ... | ||
|
||
git format-patch main | ||
git format-patch main | ||
|
||
* After reviewing the patch files, send the patches to [email protected] | ||
* After reviewing the patch files, send the patches to <[email protected]> | ||
for others to review. | ||
|
||
git send-email main | ||
git send-email main | ||
|
||
For an archived example of such an email, see | ||
"[PROPOSED] Fix off-by-1 error for Jamaica and T&C before 1913" | ||
<https://mm.icann.org/pipermail/tz/2018-February/026122.html>. | ||
|
||
* Start anew by getting current with the main branch again | ||
(the second step above). | ||
|
||
Please do not create issues or pull requests on GitHub, as the | ||
proper procedure for proposing and distributing patches is via | ||
email as illustrated above. | ||
|
||
----- | ||
|
||
This file is in the public domain. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.