h3 3.4.0 → 3.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b2531121ded47b5f0d9d2b5f5a6a335f7fd2f0fb10b3662a27d53299337742c
-  data.tar.gz: 3ba64616a8906422668fa9db3f17da9805dcfe7ff57fec8ccc32af750266dd56
+  metadata.gz: f9855fbbfa15205895e0467ef2561ec63580395d72c2cacf535c727dfca25e41
+  data.tar.gz: 2b92de2e824682fcaee25176007799203afb24180da11cac5d63d463d3649e90
 SHA512:
-  metadata.gz: 7a135032876835619d79ebef8160bbb55115058a001dae8e3bcd90091c3ff140cbb2808fa44e98af2761dccd7b2adbb7344c154796732d69ce3bd9365fd3fb84
-  data.tar.gz: 624c367307b48be1274f5a92ce600fa2f110ace2d1d8ef97285cec9e0f9fe66d08c8bf3f34a09c9968aa566b0f0158601a90127f3aa2ec201bb8923107854205
+  metadata.gz: '08630f598e940bd5f28f86292de45c50a84ac8bcd6965fd406b52cba745d825d8c3fcd18bf687831785a087f2a461a63c230b2a8bd599d26e2c9199c6516f4e3'
+  data.tar.gz: aa9fb82ed82cda98c56d75d89240cc556ca9568562d791aceaee5df084bb95b050c1d314a157d53a400020b25516ea86cf14f5e2ad18b56a0e74af4b67768aa9

data/CHANGELOG.md

@@ -6,6 +6,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 We track the MAJOR and MINOR version levels of Uber's H3 project (https://github.com/uber/h3) but maintain independent patch levels so we can make small fixes and non breaking changes.
 
+## [3.4.0] - 2019-1-24
+### Added
+- `res_0_indexes` and `res_0_index_count` support (#51).
+
 ## [3.3.1] - 2019-1-4
 ### Added
 - `h3_line` and `h3_line_size` support (#43).
@@ -19,4 +23,4 @@ We track the MAJOR and MINOR version levels of Uber's H3 project (https://github
 
 ## [3.2.0] - 2018-12-21
 
-Initial release.
+Initial release.

data/ext/h3/src/.travis.yml

@@ -57,6 +57,11 @@ matrix:
         - coveralls --lcov-file coverage.cleaned.info --verbose
     - env: NAME="Mac OSX (Xcode 8)"
       os: osx
+    - env: NAME="binding-functions target"
+      script:
+        - make binding-functions
+        # Check that the file exists and has contents
+        - test -s binding-functions
 
 # Configure the build script, out of source.
 before_script:

data/ext/h3/src/CHANGELOG.md

@@ -7,6 +7,31 @@ The public API of this library consists of the functions declared in file
 
 ## [Unreleased]
 
+## [3.4.4] - 2019-05-30
+### Changed
+- Local coordinate spaces cannot cross more than one icosahedron edge. (#234)
+- All dynamic internal memory allocations happen on the heap instead of the stack. (#235)
+- Argument parsing for `h3ToGeo`, `geoToH3`, and `h3ToGeoBoundary` is more flexible. (#227)
+
+## [3.4.3] - 2019-05-02
+### Added
+- `localIjToH3` filter application (#222)
+- An option to print distances in the `kRing` filter application (#222)
+### Changed
+- Arguments parsing for `kRing` filter application is more flexible. (#224)
+### Fixed
+- `benchmarkPolyfill` allocates its memory on the heap (#198)
+- Fixed constraints of vertex longitudes (#213)
+- Zero only input to `uncompact` does not produce an error (#223)
+
+## [3.4.2] - 2019-02-21
+### Changed
+- `binding-functions` build target generates an ASCII file on Windows (#193)
+
+## [3.4.1] - 2019-02-15
+### Fixed
+- `binding-functions` build target fixed when running the build out of source (#188)
+
 ## [3.4.0] - 2019-01-23
 ### Added
 - `getRes0Indexes` function for getting all base cells, and helper function `res0IndexCount` (#174)

data/ext/h3/src/CMakeLists.txt

@@ -79,12 +79,6 @@ include(CMakeDependentOption)
 include(CheckIncludeFile)
 include(CTest)
 
-include(CheckAlloca)
-include(CheckVLA)
-
-check_alloca(have_alloca)
-check_vla(have_vla)
-
 set(LIB_SOURCE_FILES
     src/h3lib/include/bbox.h
     src/h3lib/include/polygon.h
@@ -103,7 +97,6 @@ set(LIB_SOURCE_FILES
     src/h3lib/include/constants.h
     src/h3lib/include/coordijk.h
     src/h3lib/include/algos.h
-    src/h3lib/include/stackAlloc.h
     src/h3lib/lib/algos.c
     src/h3lib/lib/coordijk.c
     src/h3lib/lib/bbox.c
@@ -136,6 +129,7 @@ set(EXAMPLE_SOURCE_FILES
 set(OTHER_SOURCE_FILES
     src/apps/filters/h3ToGeo.c
     src/apps/filters/h3ToLocalIj.c
+    src/apps/filters/localIjToH3.c
     src/apps/filters/h3ToComponents.c
     src/apps/filters/geoToH3.c
     src/apps/filters/h3ToGeoBoundary.c
@@ -171,6 +165,7 @@ set(OTHER_SOURCE_FILES
     src/apps/testapps/testH3Distance.c
     src/apps/testapps/testH3Line.c
     src/apps/testapps/testCoordIj.c
+    src/apps/testapps/testCoordIjk.c
     src/apps/miscapps/h3ToGeoBoundaryHier.c
     src/apps/miscapps/h3ToGeoHier.c
     src/apps/miscapps/generateBaseCellNeighbors.c
@@ -310,6 +305,7 @@ add_h3_executable(geoToH3 src/apps/filters/geoToH3.c ${APP_SOURCE_FILES})
 add_h3_executable(h3ToComponents src/apps/filters/h3ToComponents.c ${APP_SOURCE_FILES})
 add_h3_executable(h3ToGeo src/apps/filters/h3ToGeo.c ${APP_SOURCE_FILES})
 add_h3_executable(h3ToLocalIj src/apps/filters/h3ToLocalIj.c ${APP_SOURCE_FILES})
+add_h3_executable(localIjToH3 src/apps/filters/localIjToH3.c ${APP_SOURCE_FILES})
 add_h3_executable(h3ToGeoBoundary src/apps/filters/h3ToGeoBoundary.c ${APP_SOURCE_FILES})
 add_h3_executable(hexRange src/apps/filters/hexRange.c ${APP_SOURCE_FILES})
 add_h3_executable(kRing src/apps/filters/kRing.c ${APP_SOURCE_FILES})
@@ -363,7 +359,7 @@ if(BUILD_TESTING)
             COMMAND bash "${CMAKE_CURRENT_BINARY_DIR}/$<CONFIG>/scripts/coverage.sh" "${CMAKE_CURRENT_SOURCE_DIR}" "${CMAKE_CURRENT_BINARY_DIR}")
         add_custom_target(clean-coverage
             # Before running coverage, clear all counters
-            COMMAND lcov --directory '${CMAKE_CURRENT_BINARY_DIR}' --zerocounters
+            COMMAND lcov --rc lcov_branch_coverage=1 --directory '${CMAKE_CURRENT_BINARY_DIR}' --zerocounters
             COMMENT "Zeroing counters"
             )
     endif()
@@ -485,6 +481,7 @@ if(BUILD_TESTING)
     add_h3_test(testH3Distance src/apps/testapps/testH3Distance.c)
     add_h3_test(testH3Line src/apps/testapps/testH3Line.c)
     add_h3_test(testCoordIj src/apps/testapps/testCoordIj.c)
+    add_h3_test(testCoordIjk src/apps/testapps/testCoordIjk.c)
     add_h3_test(testBaseCells src/apps/testapps/testBaseCells.c)
 
     add_h3_test_with_arg(testH3NeighborRotations src/apps/testapps/testH3NeighborRotations.c 0)

data/ext/h3/src/CONTRIBUTING.md

@@ -2,6 +2,8 @@
 
 Pull requests and Github issues are welcome!
 
+Planned improvements and changes are listed on the [H3 Roadmap](https://github.com/uber/h3/wiki/Roadmap). Roadmap items are currently discussed in Github issues. Feel free to open a discussion about an existing roadmap item or proposing a new one.
+
 ## Pull requests
 
 * Please include tests that show the bug is fixed or feature works as intended.

data/ext/h3/src/README.md

@@ -1,6 +1,6 @@
 # H3: A Hexagonal Hierarchical Geospatial Indexing System
 
-[![Build Status](https://travis-ci.org/uber/h3.svg?branch=master)](https://travis-ci.org/uber/h3)
+[![Build Status](https://travis-ci.com/uber/h3.svg?branch=master)](https://travis-ci.com/uber/h3)
 [![Build status](https://ci.appveyor.com/api/projects/status/61431y4sc5w0tsuk/branch/master?svg=true)](https://ci.appveyor.com/project/Uber/h3/branch/master)
 [![Coverage Status](https://coveralls.io/repos/github/uber/h3/badge.svg?branch=master)](https://coveralls.io/github/uber/h3?branch=master)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
@@ -16,7 +16,11 @@ Documentation is available at [https://uber.github.io/h3/](https://uber.github.i
 
 We recommend using prebuilt bindings if they are available for your programming language. Bindings for [Go](https://github.com/uber/h3-go), [Java](https://github.com/uber/h3-java), [JavaScript](https://github.com/uber/h3-js), [Python](https://github.com/uber/h3-py), and [others](https://uber.github.io/h3/#/documentation/community/bindings) are available.
 
-If no bindings are available, you can only install H3 by building from source.
+On macOS, you can install H3 using brew:
+```
+brew install h3
+```
+Otherwise, to build H3 from source, please see the following instructions.
 
 ### Building from source
 

data/ext/h3/src/VERSION

@@ -1 +1 @@
-3.4.0
+3.4.4

data/ext/h3/src/appveyor.yml

@@ -39,7 +39,12 @@ environment:
 build_script:
   - cmake "-G%GENERATOR%" -H. -Bbuild
   - cmake --build build --config "%CONFIG%"
+  - cmake --build build --config "%CONFIG%" --target binding-functions
 
 test_script:
   - ps: cd build
-  - ctest -VV -C "%CONFIG%"
+  - ctest -C "%CONFIG%"
+  # Check that binding-functions was generated and has content
+  - ps: |
+      $ErrorActionPreference = "Stop"
+      if ((Get-Item "binding-functions").Length -lt 10) { $host.SetShouldExit(1) }

data/ext/h3/src/docs/api/misc.md

@@ -55,3 +55,19 @@ int64_t numHexagons(int res);
 ```
 
 Number of unique **H3** indexes at the given resolution.
+
+## getRes0Indexes
+
+```
+void getRes0Indexes(H3Index *out);
+```
+
+All the resolution 0 **H3** indexes.
+
+## res0IndexCount
+
+```
+int res0IndexCount();
+```
+
+Number of resolution 0 **H3** indexes.

data/ext/h3/src/docs/community/bindings.md

@@ -6,6 +6,10 @@ As a C library, bindings can be made to call H3 functions from different program
 
 - [entrepreneur-interet-general/h3.standard](https://github.com/entrepreneur-interet-general/H3.Standard)
 
+## ECL
+
+- [hpcc-systems/HPCC-Platform](https://github.com/hpcc-systems/HPCC-Platform/tree/master/plugins/h3)
+
 ## Erlang
 
 - [helium/erlang-h3](https://github.com/helium/erlang-h3)
@@ -23,6 +27,10 @@ As a C library, bindings can be made to call H3 functions from different program
 - [uber/h3-js](https://github.com/uber/h3-js)
 - [dfellis/h3-node](https://github.com/dfellis/h3-node)
 
+## Julia
+
+- [wookay/H3.jl](https://github.com/wookay/H3.jl)
+
 ## OCaml
 
 - [travisbrady/ocaml-h3](https://github.com/travisbrady/ocaml-h3)
@@ -43,6 +51,7 @@ As a C library, bindings can be made to call H3 functions from different program
 ## R
 
 - [scottmmjackson/h3r](https://github.com/scottmmjackson/h3r)
+- [crazycapivara/h3-r](https://github.com/crazycapivara/h3-r)
 
 ## Ruby
 

data/ext/h3/src/docs/community/tutorials.md

@@ -2,6 +2,10 @@
 
 This page lists further learning materials and code walkthroughs for the H3 library and bindings. Contributions to this list are welcome, please feel free to open a [pull request](https://github.com/uber/h3/tree/master/docs/community/tutorials.md).
 
+## Java
+
+- [H3 Measurements](https://github.com/isaacbrodsky/h3measurements): Measurements of average cell area, average cell perimeter length, truncation error, and so on.
+
 ## JavaScript
 
 - [H3 Tutorials on Observable](https://beta.observablehq.com/collection/@nrabinowitz/h3-tutorial)

data/ext/h3/src/scripts/binding_functions.ps1

@@ -16,5 +16,4 @@
 # by bindings of the H3 library. It is invoked by the `binding-functions`
 # make target and produces a file `binding-functions`.
 
-$scriptDir = Split-Path -parent $PSCommandPath
-Get-Content "$scriptDir/../src/h3lib/include/h3api.h" | Where-Object {$_ -match "@defgroup ([A-Za-z0-9_]*)"} | Foreach {$Matches[1]} > binding-functions
+Get-Content "src/h3lib/include/h3api.h" | Where-Object {$_ -match "@defgroup ([A-Za-z0-9_]*)"} | Foreach {$Matches[1]} | Out-File -FilePath binding-functions -Encoding ASCII

data/ext/h3/src/scripts/binding_functions.sh

@@ -17,5 +17,6 @@
 # by bindings of the H3 library. It is invoked by the `binding-functions`
 # make target and produces a file `binding-functions`.
 
-SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
-cat "$SCRIPT_DIR/../src/h3lib/include/h3api.h" | sed -n '/@defgroup/s/.*@defgroup \([A-Za-z0-9_]*\) .*/\1/gp' > binding-functions
+set -eo pipefail
+
+cat "src/h3lib/include/h3api.h" | sed -n '/@defgroup/s/.*@defgroup \([A-Za-z0-9_]*\) .*/\1/gp' > binding-functions

data/ext/h3/src/scripts/coverage.sh.in

@@ -45,6 +45,6 @@ src_dir=${1:-"Missing source directory"}
 binary_dir=${2:-"Missing binary directory"}
 
 cd "${binary_dir}"
-lcov --directory . --capture --output-file coverage.info
-lcov --extract coverage.info "${src_dir}/src/h3lib/*" --output-file coverage.cleaned.info
-genhtml -o coverage coverage.cleaned.info --title 'h3 coverage'
+lcov --rc lcov_branch_coverage=1 --directory . --capture --output-file coverage.info
+lcov --rc lcov_branch_coverage=1 --extract coverage.info "${src_dir}/src/h3lib/*" --output-file coverage.cleaned.info
+genhtml --branch-coverage -o coverage coverage.cleaned.info --title 'h3 coverage'

data/ext/h3/src/src/apps/applib/include/utility.h

@@ -29,7 +29,63 @@
 /** Macro: Get the size of a fixed-size array */
 #define ARRAY_SIZE(x) sizeof(x) / sizeof(x[0])
 
+/** Maximum number of names an argument may have. */
+#define NUM_ARG_NAMES 2
+
+/**
+ * An argument accepted by on the command line of an H3 application. Specifies
+ * how the argument is presented, parsed, and where parsed values are stored.
+ */
+typedef struct {
+    /**
+     * Both short and long names of the argument. A name may be null, but the
+     * first name must be non-null.
+     */
+    const char* const names[NUM_ARG_NAMES];
+
+    /**
+     * If true, this argument must be specified. If the argument is not
+     * specified, argument parsing will fail.
+     */
+    const bool required;
+
+    /**
+     * Scan format for the argument, which will be passed to sscanf. May be null
+     * to indicate the argument does not take a value.
+     */
+    const char* const scanFormat;
+
+    /**
+     * Name to present the value as when printing help.
+     */
+    const char* const valueName;
+
+    /**
+     * Value will be placed here if the argument is present and scanFormat is
+     * not null.
+     */
+    void* const value;
+
+    /**
+     * Will be set to true if the argument is present. Should be false when
+     * passed in to parseArgs.
+     */
+    bool found;
+
+    /**
+     * Help text for this argument.
+     */
+    const char* const helpText;
+} Arg;
+
 // prototypes
+
+int parseArgs(int argc, char* argv[], int numArgs, Arg* args[],
+              const Arg* helpArg, const char* helpText);
+void printHelp(FILE* out, const char* programName, const char* helpText,
+               int numArgs, Arg* args[], const char* errorMessage,
+               const char* errorDetails);
+
 void error(const char* msg);
 void h3Print(H3Index h);    // prints as integer
 void h3Println(H3Index h);  // prints as integer
@@ -52,4 +108,8 @@ void iterateAllIndexesAtRes(int res, void (*callback)(H3Index));
 void iterateAllIndexesAtResPartial(int res, void (*callback)(H3Index),
                                    int maxBaseCell);
 
+int _parseArgsList(int argc, char* argv[], int numArgs, Arg* args[],
+                   const Arg* helpArg, const char** errorMessage,
+                   const char** errorDetail);
+
 #endif

data/ext/h3/src/src/apps/applib/lib/utility.c

@@ -20,14 +20,206 @@
 #include "utility.h"
 #include <assert.h>
 #include <inttypes.h>
-#include <stackAlloc.h>
+#include <stdbool.h>
 #include <stdio.h>
 #include <stdlib.h>
+#include <string.h>
 #include "coordijk.h"
 #include "geoCoord.h"
 #include "h3Index.h"
 #include "h3api.h"
 
+/*
+ * Return codes from parseArgs.
+ */
+
+#define PARSE_ARGS_SUCCESS 0
+#define PARSE_ARGS_HELP 1
+#define PARSE_ARGS_REPEATED_ARGUMENT 2
+#define PARSE_ARGS_MISSING_VALUE 3
+#define PARSE_ARGS_FAILED_PARSE 4
+#define PARSE_ARGS_UNKNOWN_ARGUMENT 5
+#define PARSE_ARGS_MISSING_REQUIRED 6
+
+/**
+ * Parse command line arguments and prints help, if needed.
+ *
+ * Uses the provided arguments to populate argument values and records in the
+ * argument if it is found.
+ *
+ * Returns non-zero if all required arguments are not present, an argument fails
+ * to parse, is missing its associated value, or arguments are specified more
+ * than once.
+ *
+ * Help is printed to stdout if a argument with isHelp = true is found, and help
+ * is printed to stderr if argument parsing fails.
+ *
+ * @param argc argc from main
+ * @param argv argv from main
+ * @param numArgs Number of elements in the args array
+ * @param args Pointer to each argument to parse
+ * @param helpArg Pointer to the argument for "--help"
+ * @param helpText Explanatory text for this program printed with help
+ * @return 0 if argument parsing succeeded, otherwise non-0. If help is printed,
+ * return value is non-0.
+ */
+int parseArgs(int argc, char* argv[], int numArgs, Arg* args[],
+              const Arg* helpArg, const char* helpText) {
+    const char* errorMessage = NULL;
+    const char* errorDetails = NULL;
+
+    int failed = _parseArgsList(argc, argv, numArgs, args, helpArg,
+                                &errorMessage, &errorDetails);
+
+    if (failed || helpArg->found) {
+        printHelp(helpArg->found ? stdout : stderr, argv[0], helpText, numArgs,
+                  args, errorMessage, errorDetails);
+        return failed != PARSE_ARGS_SUCCESS ? failed : PARSE_ARGS_HELP;
+    }
+    return PARSE_ARGS_SUCCESS;
+}
+
+/**
+ * Parse command line arguments.
+ *
+ * Uses the provided arguments to populate argument values.
+ *
+ * Returns non-zero if all required arguments are not present, an argument fails
+ * to parse, is missing its associated value, or arguments are specified more
+ * than once.
+ *
+ * @param argc argc from main
+ * @param argv argv from main
+ * @param numArgs Number of elements in the args array
+ * @param args Pointer to each argument to parse.
+ * @param helpArg Pointer to the argument for "--help" that suppresses checking
+ * for required arguments.
+ * @param errorMessage Error message to display, if returning non-zero.
+ * @param errorDetail Additional error details, if returning non-zero. May be
+ * null, and may be a pointer from `argv` or `args`.
+ * @return 0 if argument parsing succeeded, otherwise non-0.
+ */
+int _parseArgsList(int argc, char* argv[], int numArgs, Arg* args[],
+                   const Arg* helpArg, const char** errorMessage,
+                   const char** errorDetail) {
+    // Whether help was found and required arguments do not need to be checked
+    bool foundHelp = false;
+
+    for (int i = 1; i < argc; i++) {
+        bool foundMatch = false;
+
+        for (int j = 0; j < numArgs; j++) {
+            // Test this argument, which may have multiple names, for whether it
+            // matches. argName will be set to the name used for this argument
+            // if it matches.
+            const char* argName = NULL;
+            for (int k = 0; k < NUM_ARG_NAMES; k++) {
+                if (args[j]->names[k] == NULL) continue;
+
+                if (strcmp(argv[i], args[j]->names[k]) == 0) {
+                    argName = args[j]->names[k];
+                    break;
+                }
+            }
+            // argName unchanged from NULL indicates this didn't match, try the
+            // next argument.
+            if (argName == NULL) continue;
+
+            if (args[j]->found) {
+                *errorMessage = "Argument specified multiple times";
+                *errorDetail = argName;
+                return PARSE_ARGS_REPEATED_ARGUMENT;
+            }
+
+            if (args[j]->scanFormat != NULL) {
+                // Argument has a value, need to advance one and read the value.
+                i++;
+                if (i >= argc) {
+                    *errorMessage = "Argument value not present";
+                    *errorDetail = argName;
+                    return PARSE_ARGS_MISSING_VALUE;
+                }
+
+                if (!sscanf(argv[i], args[j]->scanFormat, args[j]->value)) {
+                    *errorMessage = "Failed to parse argument";
+                    *errorDetail = argName;
+                    return PARSE_ARGS_FAILED_PARSE;
+                }
+            }
+
+            if (args[j] == helpArg) {
+                foundHelp = true;
+            }
+
+            args[j]->found = true;
+            foundMatch = true;
+            break;
+        }
+
+        if (!foundMatch) {
+            *errorMessage = "Unknown argument";
+            // Don't set errorDetail, since the input could be unprintable.
+            return PARSE_ARGS_UNKNOWN_ARGUMENT;
+        }
+    }
+
+    // Check for missing required arguments.
+    if (!foundHelp) {
+        for (int i = 0; i < numArgs; i++) {
+            if (args[i]->required && !args[i]->found) {
+                *errorMessage = "Required argument missing";
+                *errorDetail = args[i]->names[0];
+                return PARSE_ARGS_MISSING_REQUIRED;
+            }
+        }
+    }
+
+    return PARSE_ARGS_SUCCESS;
+}
+
+/**
+ * Print a help message.
+ *
+ * @param out Stream to print to, e.g. stdout
+ * @param programName Program name, such as from argv[0]
+ * @param helpText Explanation of what the program does
+ * @param numArgs Number of arguments to print help for
+ * @param args Pointer to arguments to print help for
+ * @param errorMessage Error message, or null
+ * @param errorDetails Additional error detail message, or null
+ */
+void printHelp(FILE* out, const char* programName, const char* helpText,
+               int numArgs, Arg* args[], const char* errorMessage,
+               const char* errorDetails) {
+    if (errorMessage != NULL) {
+        fprintf(out, "%s: %s", programName, errorMessage);
+        if (errorDetails != NULL) {
+            fprintf(out, ": %s", errorDetails);
+        }
+        fprintf(out, "\n");
+    }
+    fprintf(out, "%s: %s\n", programName, helpText);
+    fprintf(out, "H3 %d.%d.%d\n\n", H3_VERSION_MAJOR, H3_VERSION_MINOR,
+            H3_VERSION_PATCH);
+
+    for (int i = 0; i < numArgs; i++) {
+        fprintf(out, "\t");
+        for (int j = 0; j < NUM_ARG_NAMES; j++) {
+            if (args[i]->names[j] == NULL) continue;
+            if (j != 0) fprintf(out, ", ");
+            fprintf(out, "%s", args[i]->names[j]);
+        }
+        if (args[i]->scanFormat != NULL) {
+            fprintf(out, " <%s>", args[i]->valueName);
+        }
+        fprintf(out, "\t");
+        if (args[i]->required) {
+            fprintf(out, "Required. ");
+        }
+        fprintf(out, "%s\n", args[i]->helpText);
+    }
+}
+
 void error(const char* msg) {
     fflush(stdout);
     fflush(stderr);
@@ -193,7 +385,7 @@ void iterateAllIndexesAtResPartial(int res, void (*callback)(H3Index),
         H3Index bc;
         setH3Index(&bc, 0, i, 0);
         int childrenSz = H3_EXPORT(maxUncompactSize)(&bc, 1, res);
-        STACK_ARRAY_CALLOC(H3Index, children, childrenSz);
+        H3Index* children = calloc(childrenSz, sizeof(H3Index));
         H3_EXPORT(uncompact)(&bc, 1, children, childrenSz, res);
 
         for (int j = 0; j < childrenSz; j++) {
@@ -203,5 +395,7 @@ void iterateAllIndexesAtResPartial(int res, void (*callback)(H3Index),
 
             (*callback)(children[j]);
         }
+
+        free(children);
     }
 }