H4H5TOOLS version 2.2.0 released on 2011-06-29.
================================================================================

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

This document describes the H4H5TOOLS and contains information on 
the platforms tested and limitations. The H4H5TOOLS deistribution 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:
    http://hdfgroup.org/HDF5/doc/ADGuide/H4toH5Mapping.pdf

The H4toH5 conversion library user guide and reference manual can be found at:
    http://hdfgroup.org/h4toh5/h4toh5lib_UG.pdf
    http://hdfgroup.org/h4toh5/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.6 and HDF5 v1.6.10 or v1.8.7* on the
following platforms and compilers:

   Linux 2.6 (i686), gcc 4.1.2
   Linux 2.6 (x86_64), gcc 4.1.2
   SunOS 5.10, 32/64bits (sun4u), Sun C 5.9
   Microsoft Windows XP 32/64, Visual Studio 2008

CMake was tested with HDF4 v4.2.6 and HDF5 v1.8.7 (H5_USE_16_API used) on 
the following platforms:

   Windows XP                    Visual Studio 2008
                                 Visual Studio 2010
   Windows XP x64                Visual Studio 2008
                                 Visual Studio 2010
   Windows 7                     Visual Studio 2008
   Windows 7 x64                 Visual Studio 2008

The h4toh5 command-line utility, with the option (-eos -nc4 -nc4strict) 
that can convert HDF-EOS2 to netCDF-4, is tested with HDF4 V4.2.6, 
HDF5 1.8.7*, HDF-EOS2 2.17, and ncdump from the netCDF 4.1.2 distribution
on the following platform and compiler:
   Linux 2.6 (i686), gcc 4.1.2

* Note that if you use HDF5 v1.8.0 or higher, H5_USE_16_API must be defined.
  See INSTALL_Unix.txt for details.


3. New features and bug fixes since Version 2.1.1
=================================================
   Configuration
   -------------
   - CMake Support: This release adds support for building H4H5TOOLS using
     the CMake system. Initial work has targeted Windows, but other platforms
     can be used. See the CMake.TXT file for more information. Version
     2.8.4 of CMake is required. (ADB, 2011/06/27)

   Library
   -------
   - Some HDF4 files have vgroup names with the length bigger than 
     VGNAMELENMAX, the maximum size the old HDF4 library allowed. Since the 
     h4toh5 conversion tool used VGNAMELENMAX, it caused a memory buffer 
     overrun for those files.  The current version of the conversion tool 
     uses the new HDF4 APIs (in hdf4.2.5) Vgetnamelen and Vgetclassnamelen to 
     obtain the length of vgroup and class names and to allocate a buffer of 
     the appropriate size. (KY, 2010/07/01)

   Tools
   -----
   - Update h4toh5, h5toh4, and h4toh5test to exit status to EXIT_SUCCESS(0)
     if succeeded; otherwise EXIT_FAILURE(1). (AKC, 2011/01/19)

4. Known problems
=================
   - CMake fails to build static executables on linux_x64. (ADB, 2011-06-28)
     
   - the srcdir build option doesn't work with this distribution; 
     see Bugzilla #1798 (EIP, 2010-02-25)

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

