H4H5TOOLS version 2.2.3 released on 2017-09-08
================================================================================

1. Introduction
===============

This document describes the H4H5TOOLS and contains information on
the platforms tested and limitations. The H4H5TOOLS distribution includes
three products: H4toH5 conversion library, H4toH5 conversion utility,
and H5toH4 conversion utility.

Both the H4toH5 conversion library and the H4toH5 conversion utility follow
the HDF4 to HDF5 mapping document.  This document can be found at:
    https://support.hdfgroup.org/HDF5/doc/ADGuide/H4toH5Mapping.pdf

The H4toH5 conversion library user guide and reference manual can be found at:
    https://support.hdfgroup.org/ftp/HDF5/h4toh5/src/unpacked/doc/h4toh5lib_UG.pdf
    https://support.hdfgroup.org/ftp/HDF5/h4toh5/src/unpacked/doc/h4toh5lib_RM.pdf

If you have any questions or comments, please send them to:
    help@hdfgroup.org


2. Platforms Tested
===================
This release is tested with HDF4 v4.2.13 and HDF5 v1.8.19 and v1.10.1 on the following
platforms and compilers:

   Linux 2.6 (x86_64), gcc 4.4.7
   Linux 2.6 (ppc64), gcc 4.4.7
   Linux 3.10 (x86_64), gcc 4.8.5
   Mac OS X Mavericks 10.9.5   Apple LLVM version 6.0   (clang-600.0.57)
   Mac OS X Yosemite 10.10.5   Apple LLVM version 6.1.0 (clang-602.0.53)
   Mac OS X EI Capitan 10.11.4 Apple LLVM version 7.3.0 (clang-703.0.29)
   SunOS 5.11, 32/64bits (sun4u), Sun C 5.12

   Windows 7                     Visual Studio 2012
                                 Visual Studio 2013
                                 Visual Studio 2015

   Windows 7 x64                 Visual Studio 2012
                                 Visual Studio 2013
                                 Visual Studio 2015

   Windows 10                    Visual Studio 2015

   Windows 10 x64                Visual Studio 2015

2.1 Optional Feature
====================
The h4toh5 command-line utility, with the options (-eos -nc4 -nc4strict)
that can convert HDF-EOS2 to netCDF-4, is tested with HDF4 V4.2.13,
HDF5 1.8.19, HDF-EOS2 2.19, and ncdump from the netCDF 4.4.1.1 distribution
on the following platform and compiler:

   Linux 3.10 (x86_64), gcc 4.8.5
   Mac OS X EI Capitan 10.11.4 Apple LLVM version 7.3.0 (clang-703.0.29)


3. New Features and Bug Fixes Since Version 2.2.2
=================================================
   Configuration
   -------------
   - [None]

   Library
   -------
   - Fix all the memory leakings discovered the valgrind run of the testsuite.
   - Add more testing files to test the conversion of SDS by following
     the HDF5 dimension scale specification.

   Tools
   -----
   - h4toh5 follows the HDF5 dimension scale specification to handle HDF4 SDS
     dimensions.
   - h4toh5 adds an option to support the conversion of 1 field vdata to HDF5
     dataset with the atomic datatype
   - h4toh5 uses the latest HDF4 APIs to retrieve the compression information
     for SDS and GR.
   - h4toh5 uses HDF5 variable length string to store palette names.
   - h4toh5 -eos option, fixes a bug that causes the segmentation fault of
     conversion of 1-D HDF-EOS2 swath.
   - h4toh5, add more testing files to test the conversion of SDS by following
     the HDF5 dimension scale specification.
   - h4toh5, add one testing file to test the option to convert 1 field vdata
     to an HDF5 dataset of atomic datatype.
   - Fix all the memory leakings for both h4toh5 and h5toh4 utilities discovered
     by the valgrind run of the testsuite.
   - Update the toolkit to compile and run with the HDF5 1.10 release.
   - h5h4.c file in function convert_dataset and convert_table the
     H5Tget_member_name must use the H5free_memory() to release the
     fieldame resource on Windows.

   Documentation
   -------------
   - H4toH5 mapping document is updated to version 4. The main part is to provide
     the mapping of SDS dimensions to HDF5 by following the HDF5 dimension scale
     specification.
   - The limitation of h5toh4 is documented in the h5toh4_limitation.txt under
     the directory release_docs.


4. Known problems
=================

   - [None]

5. Optional HDF-EOS2/netCDF-4 Verifier
======================================
An optional HDF-EOS2/netCDF-4 verifier utility is available with the
2.2.3 release in the subdirectory misc/verify_eos2nc4/.  See the
README.txt file under that directory.