===============================================================
H4CF Conversion Toolkit version 1.4 released on 2024-09-18
===============================================================
This is a minimal maintenance release. 
We mainly fix a bug so that the storage size of a decompressed variable that
is greater than 4GB can be converted. This bug is discovered when a MCD12Q1 
stitched file is converted. The source code is also updated to compile
with the latest compiler.
The software is tested with the HDF4.3.0,HDF5 1.14.2, HDF-EOS2.19 and  
netCDF-4.9.2 at CentOS 7 and macOS sonoma 14.3.1. 
Note: we only test the HDF4 to netCDF-4 utility with real examples.
Documentation is updated in a minimal way.
===============================================================
H4CF Conversion Toolkit version 1.3 released on 2020-03-04
===============================================================
This is a maintenance release. Valid_min and valid_max are corrected for
some MODIS products. The code quality was improved.
The software is tested with the up-to-dated HDF4,HDF5 1.10, HDF-EOS2 and  
netCDF-4 packages at CentOS 6, CentOS 7, macOS 11,macOS 13,macOS 14 and macOS 15. 
Documentation is updated in a minimal way.
===============================================================
H4CF Conversion Toolkit version 1.2 released on 2017-08-16
===============================================================
This is a minimal maintenance release. Source code is not updated.
The software is tested with the HDF4.2.13,HDF5 1.8.19, HDF-EOS2.19 and
netCDF-4.4.1.1 packages at CentOS 7, MacOS 11 and 12.
Documentation is updated in a minimal way.

===============================================================
H4CF Conversion Toolkit version 1.1 released on 2015-09-11
===============================================================

INTRODUCTION
============

  This document describes the differences between version 1.0 and 
1.1, and contains information on the platforms tested and known problems 
in version 1.1.

  For more details about the previous releases, see the file HISTORY.txt in the 
docs/ directory of the H4CF Conversion Toolkit source.

  If you have any questions or comments, please send them to the HDF-EOS forum:
 http://hdfeos.org/forums/


CONTENTS
========
- New Features
- Bug Fixes since version 1.0
- Supported Platforms and Compilers
- Known Problems
- Others

New Features
============
- We have tested and built the toolkit with MS VS on windows
- We also add the support of CentOS 7, MaC OS 10.9 and 10.10.

Support Platforms and Compilers
=======================================
--Linux 3.10.0-123.20.1.el7.x86_64 #1 SMP  GNU/Linux
  gcc (GCC) 4.8.3 20140911 (Red Hat 4.8.3-9)
- Linux 2.6.32-431.11.2.el6.x86_64 #1 SMP  GNU/Linux
  gcc (GCC) 4.4.7 20120313 (Red Hat 4.4.7-4)
- Linux 2.6.18-406.el5 #1 SMP x86_64 GNU/Linux	 
  gcc (GCC) 4.1.2 20080704 (Red Hat 4.1.2-55)
- Darwin Kernel Version 14.5.0 x86_64
  Apple LLVM version 6.1.0 (clang-602.0.53) (based on LLVM 3.6.0svn)
- Darwin Kernel Version 13.4.0 x86_64
  Apple LLVM version 6.0 (clang-600.0.56) (based on LLVM 3.5svn)
- Darwin Kernel Version 12.5.0 x86_64	 
  gcc version 4.2.1 (Based on Apple Inc. build 5658)


Bug Fixes since version 1.0
=================================
- Found a workaround solution to restore the missing HDF4 API-added objects on MacOS 10.9 and 10.10.
- Fixed the issue of missing HDF-EOS2 swath objects that use dimension maps on MacOS 10.9 and 10.10.
- Fixed the bug that causes the segmention fault for the TRMM 3A46 product.
- Fixed the bug that causes the incorrect conversion from unsigned 16-bit integer to 32-bit integer 
  in the attribute conversion inside the HDF4 to netCDF3/CF conversion utility.
- Fixed the wrong scale_factor representation in the TRMM version 7 1B products.

Known Problems
==============
- If your netcdf library doesn't support NetCDF-4 output, the h4tonccf utility 
  cannot handle unsigned integer 32 type data and attribute. Either the 
  converted file has negative values or the netcdf library throws an 
  error during conversion because NetCDF-3 doesn't support unsigned int32 type.
  The behavior varies depending on netcdf library versions and platforms.
- For some converted files (e.g., MISR-AM1_ACP-mixture-F06_0021.hdf.nc), 
  ToolsUI (netcdf-java) will not show some file attributes although 
  ncdump (netcdf-c) shows them correctly. This was reported to the netcdf-java
  developer at Unidata.
- MISR SOM projection files are not supported in this release.
- For an HDF4-added vdata object in an HDF-EOS2 hybrid file, the subset of a
  vdata field doesn't work. This is a really rare case.
- The current auto-configuration may not build the static HDF4 to netCDF-4 
  conversion tool on some Linux platforms. If one wants to build such a 
  static tool, one can follow the Makefile.template under the /utility
  to manually build it.
  
Others
==============
- For this release, this toolkit is tested with HDF4.2.11, HDF-EOS2.19,
  HDF5-1.8.15-patch1(if using netCDF-4) and netCDF-4.3.3.1.
- Users can use NcML or NCO to edit the converted netCDF files. A NcML example
  is added under the example page. One may also find the information on how to
  use NcML to edit a netCDF file in the User's guide. NCO examples can be
  found in NCO's website at sourceforge.
- User's guide and reference manual are untouched since 1.0.beta. 
-
