From ac652d59bb63e502c7ed5a032171f66db54fe45e Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Mon, 11 Aug 2014 15:51:27 -0700 Subject: [PATCH] * CONTRIBUTING: New file. * Makefile (COMMON): Add it. * README, NEWS, Theory, africa, asia, australasia, europe: * northamerica, southamerica: Mention it. --- CONTRIBUTING | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++ Makefile | 2 +- NEWS | 3 +++ README | 7 ++---- Theory | 6 ++--- africa | 3 ++- asia | 3 ++- australasia | 3 ++- europe | 3 ++- northamerica | 3 ++- southamerica | 3 ++- 11 files changed, 88 insertions(+), 15 deletions(-) create mode 100644 CONTRIBUTING diff --git a/CONTRIBUTING b/CONTRIBUTING new file mode 100644 index 0000000..508071b --- /dev/null +++ b/CONTRIBUTING @@ -0,0 +1,67 @@ +Contributing to the tz code and data + +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 tz@iana.org for use in the future. + +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. + +For more-elaborate changes, please read the Theory file and browse +the mailing list archives for +examples of patches that tend to work well. Ideally, additions to +data should contain commentary citing reliable sources as +justification. + +Please submit changes against either the latest release in + or the master branch of the experimental +Git repository. If you use Git the following workflow may be helpful: + + * Copy the experimental repository. + + git clone git@github.com:eggert/tz.git + cd tz + + * Get current with the master branch. + + git checkout master + git pull + + * Switch to a new branch for the changes. + + git checkout -b mybranch + + * Edit source files. Include commentary that justifies the + changes by citing reliable sources. + + * Debug the changes, e.g.: + + 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 + + See recent 'git log' output for the commit-message style. + + * Create patch files 0001-*, 0002-*, ... + + git format-patch master + + * After reviewing the patch files, send the patches to tz@iana.org + for others to review. + + git send-email master + + * Start anew by getting current with the master branch again. + +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. diff --git a/Makefile b/Makefile index 285ad22..42d53eb 100644 --- a/Makefile +++ b/Makefile @@ -333,7 +333,7 @@ MANTXTS= newctime.3.txt newstrftime.3.txt newtzset.3.txt \ time2posix.3.txt \ tzfile.5.txt tzselect.8.txt zic.8.txt zdump.8.txt \ date.1.txt -COMMON= Makefile README NEWS +COMMON= CONTRIBUTING Makefile README NEWS WEB_PAGES= tz-art.htm tz-link.htm DOCS= Theory $(MANS) date.1 $(MANTXTS) $(WEB_PAGES) PRIMARY_YDATA= africa antarctica asia australasia \ diff --git a/NEWS b/NEWS index d44cbf0..ce1612a 100644 --- a/NEWS +++ b/NEWS @@ -32,6 +32,9 @@ Unreleased, experimental changes Changes affecting documentation and commentary + A new file CONTRIBUTING is distributed. (Thanks to Tim Parenti + for suggesting a CONTRIBUTING file.) + tz-link.htm mentions Windows Runtime etc. (thanks to Matt Johnson) and HP-UX's tztab. diff --git a/README b/README index a6796d7..6c685b7 100644 --- a/README +++ b/README @@ -44,11 +44,8 @@ Historical local time information has been included here to: system. The information in the time zone data files is by no means authoritative; -the files currently do not even attempt to cover all time stamps before -1970, and there are undoubtedly errors even for time stamps since 1970. -If you know that the rules are different from those in a file, by all means -feel free to change a file (and please send the changed version to -tz@iana.org for use in the future). Europeans take note! +fixes and enhancements are welcome. Please see the file CONTRIBUTING +for details. Thanks to these Time Zone Caballeros who've made major contributions to the time conversion package: Keith Bostic; Bob Devine; Paul Eggert; Robert Elz; diff --git a/Theory b/Theory index 42070e4..2a3a911 100644 --- a/Theory +++ b/Theory @@ -233,9 +233,9 @@ details of pre-1970 civil timekeeping. ----- Accuracy of the tz database ----- The tz database is not authoritative, and it surely has errors. -Corrections are welcome and encouraged. Users requiring authoritative -data should consult national standards bodies and the references cited -in the database's comments. +Corrections are welcome and encouraged; see the file CONTRIBUTING. +Users requiring authoritative data should consult national standards +bodies and the references cited in the database's comments. Errors in the tz database arise from many sources: diff --git a/africa b/africa index c20a46d..37798e7 100644 --- a/africa +++ b/africa @@ -3,7 +3,8 @@ # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (2013-02-21): # diff --git a/asia b/asia index 17813ce..f8237f4 100644 --- a/asia +++ b/asia @@ -3,7 +3,8 @@ # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (2013-08-11): # diff --git a/australasia b/australasia index eceb160..094383e 100644 --- a/australasia +++ b/australasia @@ -763,7 +763,8 @@ Zone Pacific/Wallis 12:15:20 - LMT 1901 # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (2013-02-21): # A good source for time zone historical data outside the U.S. is diff --git a/europe b/europe index 5d229c2..68a0dc7 100644 --- a/europe +++ b/europe @@ -3,7 +3,8 @@ # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (2014-05-31): # A good source for time zone historical data outside the U.S. is diff --git a/northamerica b/northamerica index 88e3e33..8958588 100644 --- a/northamerica +++ b/northamerica @@ -5,7 +5,8 @@ # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (1999-03-22): # A reliable and entertaining source about time zones is diff --git a/southamerica b/southamerica index 4e00cb4..08a0731 100644 --- a/southamerica +++ b/southamerica @@ -3,7 +3,8 @@ # This data is by no means authoritative; if you think you know better, # go ahead and edit the file (and please send any changes to -# tz@iana.org for general use in the future). +# tz@iana.org for general use in the future). For more, please see +# the file CONTRIBUTING in the tz distribution. # From Paul Eggert (2006-03-22): # A good source for time zone historical data outside the U.S. is