H4H5TOOLS version 2.2.1 released on 2012-02-15.
================================================================================

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.7 and HDF5 v1.8.8 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.6
   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.7 and HDF5 v1.8.8 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*

*Note: Visual Studio 2008 will not be tested after this release (v2.2.1).

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.7, 
HDF5 1.8.8, 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


3. New features and bug fixes since Version 2.2.0
=================================================
   Configuration
   -------------
   - Remove the dependency for the preprocessor option,
     CPPFLAGS=-DH5_USE_16_API, if using HDF5 1.8 or higher. (LD, KY -2011-12-20)

   Library
   -------
   - Remove the macro LIBH4TOH5_VERSION from h4toh5main.c and h4toh5util.h
     since it is not used to output the version number (KY -2011-12-22)

   Tools
   -----
   - Update expected output HDF4 files for the h5toh4 conversion utility
     based on the bug fix of the HDF5 image conversion. (KY - 2011-12-22)
   - Update expected output HDF5 files for the -eos2 option of the h4toh5 
     conversion utility with HDF5 1.8.7. (LD,KY -2011-12-20)
   - Starting with version 2.2.1, the -nc4 and -nc4fakedim options for
     converting HDF-EOS2 to netCDF-4 is no longer supported.  
    
   Documentation
   -------------
   - Entries have been added in the Reference Manual for the command-line 
     utilities 'h4toh5' and 'h5toh4'.


4. Known problems
=================
   - configure sometimes failed with the following message:
       checking for H5open in -lhdf5... no
       configure: error: cannot find HDF5 library.
     This was due to libhdf5.a uses functions in libm.a. The h4cc usually has
     -lm included but some newer compilers (e.g., gcc v4.4.x) decides,
     correctly, h4cc does not need -lm and does not include -lm in the
     generated h4cc.  One way to go around this error is by adding -lm to $CC
     when running configure. E.g.,
	env CC="/usr/local/hdf4/h4cc -lm" ./configure --with-hdf5=<hdf5libpath>
    This problem will be fixed in the next release. (AC, 2012-02-13)
   - Windows linking issues with non-CMake builds of HDF5 library. Usual error
     reported is that timezone structure cannot be found. (ADB, 2012-02-13)
   - 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.

