hdx_util.hpp: new function signatures and documentation