H4H5TOOLS version 2.2.2 released on 2013-07-26
================================================================================

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:
    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.9 and HDF5 v1.8.11 on the following
platforms and compilers:

   Linux 2.6 (i686), gcc 4.1.2
   Linux 2.6 (x86_64), gcc 4.1.2
   Linux 2.6 (ppc64), gcc 4.4.7
   SunOS 5.11, 32/64bits (sun4u), Sun C 5.12

CMake was tested with HDF4 v4.2.9 and HDF5 v1.8.11 on the following platforms:

    Windows 7                     Visual Studio 2008
                                  Visual Studio 2010
                                  Visual Studio 2012

    Windows 7 x64                 Visual Studio 2008
                                  Visual Studio 2010
                                  Visual Studio 2012

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.9, 
HDF5 1.8.11, HDF-EOS2 2.18, and ncdump from the netCDF 4.2.1.1 distribution
on the following platform and compiler:

   Linux 2.6 (i686), gcc 4.1.2


3. New Features and Bug Fixes Since Version 2.2.1
=================================================
   Configuration
   -------------
   - Configure has been improved to find other libraries on which the HDF5 library
     depends (uses). It consults the file libhdf5.la in the same directory
     where the HDF5 Library resides. This also fixes the previously known problem
     where the h4cc compiler command does not link the -lm library.
     (AKC 2013-07-23 HFRHFVTOOLS-74 and HFRHFVTOOLS-79).

   Library
   -------
   - [None]

   Tools
   -----
   - For the HDF5 compound datatype mapping of the h5toh4 conversion tool, 
     the map of fixed-size HDF5 string to HDF4 char type was added.
   - A new HDF5 testing file and the corresponding expected output were also
     added. (KY -2012-07-18)
    
   Documentation
   -------------
   - [None]


4. Known problems
=================
   - The srcdir build option doesn't work with this distribution; 
     see Bugzilla #1798 (EIP, 2010-02-25, OTHER-8)


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

