Merge pull request #97 from bxparks/develop

merge 1.11.3 into master

Author: bxparks

CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 
 * Unreleased
+* 1.11.3 (2022-03-20, TZDB 2022a)
+    * Update to TZDB 2022a.
+        * https://mm.icann.org/pipermail/tz-announce/2022-March.txt
+        * "Palestine will spring forward on 2022-03-27, not -03-26."
+    * No changes to code.
 * 1.11.2 (2022-02-24, TZDB 2021e)
     * Fix crash triggered by certain subclasses of `BasicZoneProcessor` and
       `ExtendedZoneProcessor`.

DEVELOPER.md

@@ -584,57 +584,30 @@ available.
   should be a sibling to the `AceTime` repo:
     * `$ cd ../date`
     * `$ git pull`
-* Verify that the `AceTime` library and the Hinnant `date` library agree with
-  each other using the same TZDB version. This requires going into the
-  [AceTimeValidation](https://github.com/bxparks/AceTimeValidation) project.
-    * BasicHinnantDateTest
-        * `$ cd .../AceTimeValidation/BasicHinnantDateTest`
-        * Update the `TZ_VERSION` variable in the `Makefile` with the commit tag
-          of the new TZDB version. (e.g. `TZ_VERSION = 2020c`).
-        * `$ make clean`
-        * `$ make`
-        * `$ ./BasicHinnantDateTest.out | grep failed`
-        * There should be no failures.
-    * ExtendedHinnantDateTest
-        * `$ cd .../AceTimeValidation/ExtendedHinnantDateTest`
-        * Update the `TZ_VERSION` variable in the `Makefile` with the commit tag
-          of the new TZDB version. (e.g. `TZ_VERSION = 2020c`).
-        * `$ make clean`
-        * `$ make`
-        * `$ ./ExtendedHinnantDateTest.out | grep failed`
-        * There should be no failures.
 * Update the zonedb files for AceTimePython (needed by BasicAcetzTest and
   ExtendedAcetzTest):
     * `$ cd AceTimePython/src/acetime/zonedb`
-    * Edit the `Makefile` and update the `TZ_VERSION`.
+    * Update the `TZ_VERSION` variable in `Makefile`.
     * `$ make`
-* Verify that the `AceTime` library and the `AceTimePython` library agree with
-  each other using the same TZDB version. This requires going into the
-  [AceTimeValidation](https://github.com/bxparks/AceTimeValidation) project.
-    * BasicAcetzTest
-        * `$ cd .../AceTimeValidation/BasicAcetzTest`
-        * Update the `TZ_VERSION` variable in the `Makefile` with the commit tag
-          of the new TZDB version. (e.g. `TZ_VERSION = 2020c`).
-        * `$ make clean`
-        * `$ make`
-        * `$ ./BasicAcetzTest.out | grep failed`
-        * There should be no failures.
-    * ExtendedAcetzTest
-        * `$ cd .../AceTimeValidation/ExtendedAcetzTest`
-        * Update the `TZ_VERSION` variable in the `Makefile` with the commit tag
-          of the new TZDB version. (e.g. `TZ_VERSION = 2020c`).
-        * `$ make clean`
-        * `$ make`
-        * `$ ./ExtendedAcetzTest.out | grep failed`
-        * There should be no failures.
+* Verify that `AceTimeValidation` passes (which compares AceTime with
+  AceTimePython and the Hinnant `date` library):
+    * `$ cd ../AceTimeValidation`
+    * Update the `TZ_VERSION` variable in the following files:
+        * `BasicAcetzTest/Makefile`
+        * `ExtendedAcetzTest/Makefile`
+        * `BasicHinnantDateTest/Makefile`
+        * `ExtendedHinnantDateTest/Makefile`
+    * `$ make clean`
+    * `$ make validations`
+    * `$ make runvalidations`
 * Update the various zoneinfo files for AceTime:
     * `zonedb`
-        * `$ cd src/ace_time/zonedb`
-        * Edit the `Makefile` and update the `TZ_VERSION`.
+        * `$ cd AceTime/src/ace_time/zonedb`
+        * Update the `TZ_VERSION` variable in `Makefile`.
         * `$ make`
     * `zonedbx`
-        * `$ cd src/ace_time/zonedbx`
-        * Edit the `Makefile` and update the `TZ_VERSION`.
+        * `$ cd AceTime/src/ace_time/zonedbx`
+        * Update the `TZ_VERSION` variable in `Makefile`.
         * `$ make`
 * Update CHANGELOGs
     * AceTime/CHANGELOG.md
@@ -644,12 +617,26 @@ available.
     * `$ git add ...`
     * `$ git commit -m "..."`
 
-There are 6 other validation tests in the AceTimeValidation project that compare
-AceTime with other third party libraries (Python pytz, Python dateutil, and Java
-date). Unfortunately, they all seem to use the underlying TZDB version provided
-by the Operating System, and I have not been able to figure out how to manually
-update this dependency manually. When a new TZDB is released, all of these other
-tests will fail until the underlying timezone database of the OS is updated.
+There are 12 other validation tests in the AceTimeValidation project that
+compare AceTime with various other third party libraries:
+
+* `BasicDateUtilTest`
+* `BasicGoTest`
+* `BasicJavaTest`
+* `BasicNodaTest`
+* `BasicPytzTest`
+* `BasicZoneInfoTest`
+* `ExtendedDateUtilTest`
+* `ExtendedGoTest`
+* `ExtendedJavaTest`
+* `ExtendedNodaTest`
+* `ExtendedPytzTest`
+* `ExtendedZoneInfoTest`
+
+Unfortunately, they all seem to use the underlying TZDB version provided by the
+Operating System, and I have not been able to figure out how to manually update
+this dependency manually. When a new TZDB is released, all of these tests will
+fail until the underlying timezone database of the OS is updated.
 
 <a name="ReleaseProcess"></a>
 ## Release Process

README.md

@@ -53,7 +53,7 @@ This library can be an alternative to the Arduino Time
 (https://github.com/PaulStoffregen/Time) and Arduino Timezone
 (https://github.com/JChristensen/Timezone) libraries.
 
-**Version**: 1.11.2 (2022-02-24, TZDB version 2021e)
+**Version**: 1.11.3 (2022-03-20, TZDB version 2022a)
 
 **Changelog**: [CHANGELOG.md](CHANGELOG.md)
 

USER_GUIDE.md

@@ -4,7 +4,7 @@ The primary purpose of AceTime classes is to convert between an integer
 representing the number of seconds since the AceTime Epoch (2000-01-01T00:00:00
 UTC) and the equivalent human-readable components in different timezones.
 
-**Version**: 1.11.2 (2021-02-24, TZDB 2021e)
+**Version**: 1.11.3 (2021-03.20, TZDB 2022a)
 
 **Related Documents**:
 
@@ -2046,7 +2046,7 @@ in the `transformer.py` script and summarized in
 * the UNTIL time suffix can only be 'w' (not 's' or 'u')
 * there can be only one DST transition in a single month
 
-As of version v1.9 (with TZDB 2021e), this database contains 258 Zone entries
+As of version v1.11.3 (with TZDB 2022a), this database contains 258 Zone entries
 and 193 Link entries, supported from the year 2000 to 2049 (inclusive).
 
 <a name="ExtendedZonedbx"></a>
@@ -2063,7 +2063,7 @@ are:
 * the AT and UNTIL fields are multiples of 1-minute
 * the LETTER field can be arbitrary strings
 
-As of version v1.9 (with TZDB 2021e), this database contains all 377 Zone
+As of version v1.11.3 (with TZDB 2022a), this database contains all 377 Zone
 entries and 217 Link entries, supported from the year 2000 to 2049 (inclusive).
 
 <a name="TzDatabaseVersion"></a>
@@ -2666,7 +2666,7 @@ void printZones(uint16_t indexes[], uint16_t size) {
 
 void sortAndPrintZones() {
   // Create the indexes[kZoneAndLinkRegistrySize] on the stack. This has 594
-  // elements as of TZDB 2021e, so this requires a microcontroller which can
+  // elements as of TZDB 2022a, so this requires a microcontroller which can
   // support at least 1188 bytes on the stack.
   uint16_t indexes[zonedbx::kZoneAndLinkRegistrySize];
 

docs/doxygen.cfg

@@ -38,7 +38,7 @@ PROJECT_NAME           = "AceTime"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 1.11.2
+PROJECT_NUMBER         = 1.11.3
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

docs/html/AceTime_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">1.11.2</span>
+   &#160;<span id="projectnumber">1.11.3</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>
@@ -126,8 +126,8 @@
 <div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="time__period__mutation_8h.html">ace_time/time_period_mutation.h</a>&quot;</span></div>
 <div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160; </div>
 <div class="line"><a name="l00066"></a><span class="lineno">   66</span>&#160;<span class="comment">// Version format: xxyyzz == &quot;xx.yy.zz&quot;</span></div>
-<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;<span class="preprocessor">#define ACE_TIME_VERSION 11102</span></div>
-<div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;<span class="preprocessor">#define ACE_TIME_VERSION_STRING &quot;1.11.2&quot;</span></div>
+<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;<span class="preprocessor">#define ACE_TIME_VERSION 11103</span></div>
+<div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;<span class="preprocessor">#define ACE_TIME_VERSION_STRING &quot;1.11.3&quot;</span></div>
 <div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160; </div>
 <div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;<span class="preprocessor">#endif</span></div>
 </div><!-- fragment --></div><!-- contents -->

docs/html/BasicBrokers_8cpp_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">1.11.2</span>
+   &#160;<span id="projectnumber">1.11.3</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BasicBrokers_8h.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">1.11.2</span>
+   &#160;<span id="projectnumber">1.11.3</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BasicBrokers_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">1.11.2</span>
+   &#160;<span id="projectnumber">1.11.3</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>

docs/html/BasicZoneProcessor_8h_source.html

@@ -22,7 +22,7 @@
  <tr style="height: 56px;">
   <td id="projectalign" style="padding-left: 0.5em;">
    <div id="projectname">AceTime
-   &#160;<span id="projectnumber">1.11.2</span>
+   &#160;<span id="projectnumber">1.11.3</span>
    </div>
    <div id="projectbrief">Date and time classes for Arduino that support timezones from the TZ Database.</div>
   </td>