HDF5 Release 1.4.1


INTRODUCTION

This document describes the differences between HDF5-1.4.0 and
HDF5-1.4.1, and contains information on the platforms tested and
known problems in HDF5-1.4.1. For more details check the HISTORY.txt
file in the HDF5 source.

The HDF5 documentation can be found on the NCSA ftp server
(ftp.ncsa.uiuc.edu) in the directory:

     /HDF/HDF5/docs/

For more information look at the HDF5 home page at:
   
    http://hdf.ncsa.uiuc.edu/HDF5/

If you have any questions or comments, please send them to:

    hdfhelp@ncsa.uiuc.edu


CONTENTS

- New Features
- Bug Fixes since HDF5-1.4.0
- Documentation
- Platforms Tested
- Supported Configuration Features
- Known Problems


New Features
============

   * XML output option for h5dump utility.
  
     A new option --xml to output data in XML format has been added. The
     XML output contains a complete description of the file, marked up in
     XML. 

     The XML conforms to the HDF5 Document Type Definition (DTD), which
     is available at:

       http://hdf.ncsa.uiuc.edu/DTDs/HDF5-File.dtd

     The XML output is suitable for use with other tools, including the
     Java Tools:

       http://hdf.ncsa.uiuc.edu/java-hdf5-html


Bug Fixes since HDF5-1.4.0 Release
==================================

   * h4toh5 utility: conversion of images is fixed

     Earlier releases of the h4toh5 utility produced images that did not
     correctly conform to the HDF5 Image and Palette Specification.

       http://hdf.ncsa.uiuc.edu/HDF5/doc/ImageSpec.html

     Several required HDF5 attributes are omitted, and the dataspace
     is reversed (i.e., the ht. and width of the image dataset is
     incorrectly described.)  For more information, please see:

       http://hdf.ncsa.uiuc.edu/HDF5/H5Image/ImageDetails.html

   * Fixed bug with contiguous hyperslabs not being detected, causing
     slower I/O than necessary.
   * Fixed bug where non-aligned hyperslab I/O on chunked datasets was
     causing errors during I/O
   * The RCSID string in H5public.h was causing the C++ compiling problem
     because when it was included multiple times, C++ did not like
     multiple definitions of the same static variable. All occurance of
     RCSID definition are removed since we have not used it consistently
     before.


Documentation
=============

    PDF and Postscript versions of the following documents are available 
    for this release:
        Document                                 Filename
        --------                                 --------
        Introduction to HDF5                     H5-R141-Introduction.pdf
        HDF5 Reference Manual                    H5-R141-RefManual.pdf 
        C++ APIs to HDF5 documents               H5-R141-Cplusplus.pdf
        Fortran90 APIs to HDF5 documents         H5-R141-Fortran90.pdf

        PDF and Postscript files containing      H5-R141-DocSet.pdf
            all of the above                     H5-R141-DocSet.ps

    These files are not included in this distribution, but are available 
    via the Web or FTP at the following locations:
        http://hdf.ncsa.uiuc.edu/HDF5/doc/PSandPDF/
        ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/docs/

    While these documents are labeled Release 1.4.1, they describe 
    Release 1.4.0 as well.  


Platforms Tested
================

Due to the nature of this release only C, C++ libraries and tools were tested.

    AIX 4.3.3.0 (IBM SP powerpc)  xlc 3.6.6
                                  mpcc_r 3.6.6
    Cray T3E sn6711 2.0.5.47      Cray Standard C Version 6.5.0.0
    Cray SV1 10.0.0.8             Cray Standard C Version 6.5.0.0
    FreeBSD 4.3                   gcc 2.95.2
    HP-UX B.10.20                 HP C  HP92453-01 A.10.32.30
    HP-UX B.11.00                 HP C  HP92453-01 A.11.01.20
    IRIX 6.5                      MIPSpro cc 7.30
                                  mpich-1.2.1
    IRIX64 6.5 (64 & n32)         MIPSpro cc 7.3.1m
                                  mpt.1.4.0.2
                                  mpich-1.2.1
    Linux 2.2.18smp               gcc-2.95.2
                                  g++ 2.95.2
                                  mpich-1.2.1
    OSF1 V4.0                     DEC-V5.2-040
                                  Digital Fortran 90 V4.1-270
    SunOS 5.6                     WorkShop Compilers 5.0 98/12/15 C 5.0 
     (Solaris 2.6)                

    SunOS 5.7                     WorkShop Compilers 5.0 98/12/15 C 5.0
     (Solaris 2.7)                Workshop Compilers 5.0 98/12/15 C++ 5.0
                                  mpich-1.2.1
    TFLOPS r1.0.4 v4.0            mpich-1.2.1 with local changes
    Windows NT4.0, 2000 (NT5.0)   MSVC++ 6.0
    Windows 98                    MSVC++ 6.0


Supported Configuration Features Summary
========================================

    * See "Supported Configuration Features Summary" section for the HDF5
      1.4.0 release in the HISTORY.txt file.

Known Problems
==============

    * The --enable-static-exec configure flag fails to compile for HP-UX
      11.00 platforms.
    * See "Known problems" section for the HDF5 1.4.0 release in the
      HISTORY.txt file.