[svn-r15980] add mention to h5diff long double

1 files changed, 402 insertions, 414 deletions

diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index ce8274f..afcaf60 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -1,174 +1,192 @@
-HDF5 version 1.8.1-snap8 currently under development
+HDF5 version 1.9.21 currently under development
 ================================================================================
 
-INTRODUCTION
-============
-
-This document describes the differences between the HDF5-1.8.1-snap* releases 
-and HDF5 1.8.1, and contains information on the platforms tested and known 
-problems in HDF5-1.8.1-snap*.  For more details, see the files
-HISTORY-1_0-1_8_0_rc3.txt and HISTORY-1_8.txt in the release_docs/ directory 
-of the HDF5 source.
-
-Links to the HDF5 1.8.1 source code, documentation, and additional materials
-can be found on the HDF5 web page at:
-
-     http://www.hdfgroup.org/products/hdf5/
-
-The HDF5 1.8.1 release can be obtained from:
-
-     http://www.hdfgroup.org/HDF5/release/obtain5.html
-
-User documentation for 1.8.1 can be accessed directly at this location: 
 
-     http://www.hdfgroup.org/HDF5/doc/
+INTRODUCTION
 
-New features in the HDF5-1.8.x release series, including brief general 
-descriptions of some new and modified APIs, are described in the "What's New 
-in 1.8.0?" document:
+This document describes the differences between HDF5-1.9.0 and
+HDF5 1.9.x snapshot, and contains information on the platforms 
+tested and known problems in HDF5-1.9.x. 
+For more details check the HISTORY*.txt files in the HDF5 source.
 
-     http://www.hdfgroup.org/HDF5/doc/ADGuide/WhatsNew180.html
 
-All new and modified APIs are listed in detail in the "HDF5 Software Changes 
-from Release to Release" document, in the section "Release 1.8.1 (current 
-release) versus Release 1.8.0":
+Links to HDF5 1.9.x source code can be found on THG's development 
+FTP server at the following location:
+     ftp://ftp.hdfgroup.uiuc.edu/pub/outgoing/hdf5/snapshots
+User documentation for the snapshot can be accessed directly at this location: 
+     http://www.hdfgroup.uiuc.edu/HDF5/doc_dev_snapshot/H5_dev/
 
-     http://www.hdfgroup.org/HDF5/doc/ADGuide/Changes.html
+For more information, see the HDF5 home page:
+   
+    http://www.hdfgroup.org/HDF5/
 
 If you have any questions or comments, please send them to the HDF Help Desk:
 
-     help@hdfgroup.org
+    help@hdfgroup.org
 
 
 CONTENTS
-========
 
 - New Features
 - Support for new platforms and languages
-- Bug Fixes since HDF5-1.8.1
+- Bug Fixes since HDF5-1.8.0
 - Platforms Tested
-- Supported Configuration Features Summary
 - Known Problems
 
 
 New Features
 ============
 
-        Configuration
-        -------------
-        - Upgraded libtool to version 2.2.6a. MAM 2008/10/15.
-
-        Source code distribution
-        ========================
-
-        Library
-        -------
-	- Added two new public routines: H5Pget_elink_fapl() and
-      	  H5Pset_elink_fapl(). (see bug #1247) (VC - 2008/10/13)
-        - Improved free space tracking in file to be faster. (QAK - 2008/10/06)
-        - Added 'mounted' field to H5G_info_t struct. (QAK - 2008/07/15)
-
-        Parallel Library
-        ----------------
-        - None
-
-        Tools
-        -----
-        - h5repack: add a userblock to an HDF5 file during the repack. (PVN - 2008/08/26)
-        - h5repack: add 2 options that call H5Pset_alignment in the repacked file. (PVN - 2008/08/29)
-        - h5ls: added capability to traverse through external links when the -r
-            (recursive) flag is given. (NAF - 2008/09/16)
-        - h5ls: added -E option to enable traversal of external links.  h5ls will
-            not traverse external links without this flag being set.
-            (NAF - 2008/10/06)
-
-
-
-        F90 API
-        ------
-         - Added optional parameter 'mounted' to H5Gget_info_f, H5Gget_info_by_idx_f,
-           H5Gget_info_by_name_f (MSB - 2008/09/24)
-	 - Added H5Tget_native_type_f (MSB - 2008/09/30)
-	 
-	 
-        C++ API
-        ------
-        - None
-
-
-Support for New Platforms, Languages, and Compilers
-===================================================
-        - None
-
-
-Bug Fixes since HDF5-1.8.1 
-==========================
-
-        Configuration
-        -------------
-        - Fixed error with 'make check install' failing due to h5dump
-          needing other tools built first. MAM - 2008/10/15.
-        - When using shared szip, it is no longer necessary to specify
-          the path to the shared szip libraries in LD_LIBRARY_PATH. MAM - 
-          2008/10/15.
-	- The file libhdf5_fortran.settings is not installed since its content
-	  is included in libhdf5.settings now. AKC - 2008/10/21
-        - "make DESTDIR=xxx install" failed to install some tools and files
-          (e.g., h5cc and fortran modules). Fixed. AKC - 2008/10/8.
-
-        Source code distribution
-        ========================
-
-        Library
-        -------
-        - Fixed an error where a null message could be created that was larger
+    Configuration:
+    -------------
+    - Configuration suite now uses Libtool 2.2.6a. MAM 2008/10/24
+
+    - Configuration suite now uses Autoconf 2.61, Automake 1.10.1. 
+      MAM 2008/05/05. 
+
+    - The new configure option "--disable-sharedlib-rpath" disables
+      embedding the '-Wl,-rpath' information into executables when
+      shared libraries are produced, and instead solely relies on the
+      information in LD_LIBRARY_PATH. (MAM - 2008/05/15)
+
+    Library:
+    --------
+    - Added two new public routines: H5Pget_elink_fapl() and
+      H5Pset_elink_fapl(). (see bug #1247) (VC - 2008/10/13)
+    - Improved free space tracking in file to be faster. (QAK - 2008/10/06)
+    - Added 'mounted' field to H5G_info_t struct. (QAK - 2008/07/15)
+
+    Parallel Library:
+    -----------------
+
+    Fortran Library:
+    ----------------
+
+    C++ Library:
+    ------------
+        - These member functions were added as wrapper for H5Rdereference to
+          replace the incorrect IdComponent::dereference().
+                void H5Object::dereference(H5File& h5file, void* ref)
+                void H5Object::dereference(H5Object& obj, void* ref)
+          In addition, these constructors were added to create the associated
+          objects by way of dereference:
+                Attribute(H5Object& obj, void* ref);
+                Attribute(H5File& file, void* ref);
+                DataSet(H5Object& obj, void* ref);
+                DataSet(H5File& file, void* ref);
+                DataType(H5Object& obj, void* ref);
+                DataType(H5File& file, void* ref);
+                Group(H5Object& obj, void* ref);
+                Group(H5File& obj, void* ref);
+          (BMR - 2008/08/10)
+
+
+
+    Tools:
+    ------
+
+     - h5dump: added a printing of the compression ratio of uncompressed and compressed 
+         sizes for cases where compression  filters are present. (PVN - 2008/05/01)
+     - h5dump: added an option to allow a user defined formatting string for printf 
+         regarding floating point numbers. (PVN - 2008/05/06)
+     - h5dump: support for external links, display the object that the external link 
+         points to. (PVN - 2008/05/12)
+     - h5repack: add a userblock to an HDF5 file during the repack. (PVN - 2008/08/26)
+     - h5repack: add 2 options that call H5Pset_alignment in the repacked file. (PVN - 2008/08/29)
+     - h5ls: added capability to traverse through external links when the -r
+         (recursive) flag is given. (NAF - 2008/09/16)
+     - h5ls: added -E option to enable traversal of external links.  h5ls will
+         not traverse external links without this flag being set.
+         (NAF - 2008/10/06)
+     - h5diff: added support for long double (PVN - 2008/10/28)
+
+
+
+
+    High-Level APIs:
+    ------
+    
+    Documentation 
+    ------------- 
+
+Support for new platforms, languages and compilers.
+=======================================
+
+Bug Fixes since HDF5-1.8.0 release
+==================================
+
+    Library
+    -------
+      - Fixed an error where a null message could be created that was larger
             than could be written to the file.  (NAF - 2008/10/23)
-        - Corrected error with family/split/multi VFD not updating driver info
+      - Corrected error with family/split/multi VFD not updating driver info
             when "latest" version of the file format used. (QAK - 2008/10/14)
-        - Corrected alignment+threshold errors to work correctly when metadata
+      - Corrected alignment+threshold errors to work correctly when metadata
             aggregation is enabled. (QAK - 2008/10/06)
-        - Changed H5Fget_obj_count and H5Fget_obj_ids to ignore objects
-            registered by the library for internal library use.
+      - Changed H5Fget_obj_count and H5Fget_obj_ids to ignore objects registered
+            by the library for internal library use.  (NAF - 2008/10/06)
+      - Fixed potential memory leak during compound conversion.
             (NAF - 2008/10/06)
-        - Fixed potential memory leak during compound conversion.
-            (NAF - 2008/10/06)
-        - Changed the return value of H5Fget_obj_count from INT to SSIZE_T. Also
+      - Changed the return value of H5Fget_obj_count from INT to SSIZE_T. Also
             changed the return value of H5Fget_obj_ids from HERR_T to SSIZE_T and
-            the type of the parameter MAX_OBJS from INT to SIZE_T. (SLU - 2008/09/26)
-        - Fixed an issue that could cause data to be improperly overwritten
+            the type of the parameter MAX_OBJS from INT to SIZE_T. (SLU - 2008/09/26) 
+      - Fixed an issue that could cause data to be improperly overwritten
             during compound type conversion.  (NAF - 2008/09/19)
-        - Fixed pointer alignment violations that could occur during vlen
+      - Fixed pointer alignment violations that could occur during vlen
             conversion.  (NAF - 2008/09/16)
-        - Fixed problem where library could cause a segmentation fault when
+      - Fixed problem where library could cause a segmentation fault when
             an invalid location ID was given to H5Giterate(). (QAK - 2008/08/19)
-        - Fixed improper shutdown when objects have reference count > 1.  The
+      - Fixed improper shutdown when objects have reference count > 1.  The
             library now tracks reference count due to the application separately
             from that due to internal library routines.  (NAF - 2008/08/19)
-        - Fixed assertion failure caused by incorrect array datatype version.
+      - Fixed assertion failure caused by incorrect array datatype version.
             (NAF - 2008/08/08)
-        - Fixed an issue where mount point traversal would fail when using
+      - Fixed an issue where mount point traversal would fail when using
             multiple handles for the child.  (NAF - 2008/08/07)
-        - Fixed an issue where mount points were inaccessible when using multiple
+      - Fixed an issue where mount points were inaccessible when using multiple
             file handles for the parent.  The mount table is now in the shared
             file structure (the parent pointer is still in the top structure).
             (NAF - 2008/08/07)
-        - Fixed issue where a group could have a file mounted on it twice.
+      - when an attribute was opened twice and data was written with one of the handles,
+            the file didn't have the data.  It happened because each handle had its own
+            object structure, and the empty one overwrote the data with fill value.  This is
+            fixed by making some attribute information like the data be shared in the
+            attribute structure.  SLU - 2008/07/22
+      - Fixed issue where a group could have a file mounted on it twice.
             (QAK - 2008/07/15)
-        - when an attribute was opened twice and data was written with one of the handles, 
-          the file didn't have the data.  It happened because each handle had its own 
-          object structure, and the empty one overwrote the data with fill value.  This is
-          fixed by making some attribute information like the data be shared in the 
-          attribute structure.  SLU - 2008/07/07
-        - Fixed a Windows-specific issue in the ohdr test which was causing users
-          in some timezones to get false errors.  This a deficiency in the Windows
-          mktime() function, and has been handled properly.  SJW  - 2008/06/19
-
-        Parallel Library
-        ----------------
-        - None
-
-        Tools
-        -----
+      - Fixed a Windows-specific issue in the ohdr test which was causing users
+        in some timezones to get false errors.  This a deficiency in the Windows
+        mktime() function, and has been handled properly.  SJW  - 2008/06/19
+      - Fixed the problem with the searching of target file for H5Lcreate_external().
+	    The searching pattern will depend on whether the target file's
+	    pathname is an absolute or a relative path. Please see the description
+	    in the RM for H5Lcreate_external().  (VC - 2008/04/08)
+      - Fixed possible file corruption bug when encoding datatype
+            descriptions for compound datatypes whose size was between
+            256 & 511 bytes and the file was opened with the "use the
+            latest format" property enabled (with H5Pset_libver_bounds).
+            (QAK - 2008/03/13)
+      - Fixed bug in H5Aget_num_attrs() routine to handle invalid location
+            ID correctly.  (QAK - 2008/03/11)
+
+
+    Configuration
+    -------------
+    - Fixed error with 'make check install' failing due to h5dump
+      needing other tools built first. MAM - 2008/10/24.
+    - When using shared szip, it is no longer necessary to specify
+      the path to the shared szip libraries in LD_LIBRARY_PATH. MAM - 
+      2008/10/24.
+    - The file libhdf5_fortran.settings is not installed since its content
+      is included in libhdf5.settings now. AKC - 2008/10/21
+    - "make DESTDIR=xxx install" failed to install some tools and files
+      (e.g., h5cc and fortran modules). Fixed. AKC - 2008/10/8.
+
+    Performance
+    -------------
+
+    Tools
+    -----
         - h5dump now checks for uniqueness of committed datatypes.
             (NAF - 2008/10/15)
         - Fixed unnecessary indentation of committed datatypes in h5dump.
@@ -178,63 +196,64 @@ Bug Fixes since HDF5-1.8.1
           (see bug #1253) (VC- 2008/10/13)
         - Fixed bug in h5ls that prevented relative group listings (like
             "h5ls foo.h5/bar") from working correctly (QAK - 2008/06/03)
+        - Fixed bug in h5diff that prevented datasets & attributes with
+            variable-length string elements from comparing correctly.
+            (QAK - 2008/02/28)
+        - h5import bug on Windows w/binary datasets. fread in windows needs a
+            binary file to be open with 'rb' instead of 'r' otherwise it
+            terminates execution if an end of file character is found on the
+            input file. Besides that the binary file generated needs to be open
+            with 'wb' , otherwise an end of line character is read twice.
+            (PVN - 2008/02/19)
+        - Fixed bug in h5dump that caused binary output to be made only for the first 
+           dataset, when several datasets were requested. (PVN - 2008/04/07)
         - h5dump: when doing binary output (-b), the stdout printing of attributes 
            was done incorrectly. Removed printing of attributes when doing binary 
            output. PVN - 2008/06/05
 
 
-        F90 API
-        ------
-        - h5sselect_elements_f: Added additional operators H5S_SELECT_APPEND and 
-           H5S_SELECT_PREPEND (MSB 9/30/2008)
-	- h5sget_select_elem_pointlist: Fixed list of returned points by rearranging the point
-           list correctly by accounting for C conventions.(MSB 9/30/2008)
-        - h5sget_select_hyper_blocklist_f: Fixed error in transposed dimension of 
-           arrays.(MSB 9/30/2008)
-        - h5sget_select_bounds_f: Swapped array bounds to account for C and Fortran reversed 
-           array notation (MSB 9/30/2008)
-	- Changed to initializing string to a blank character instead of a null type in
-           tH5P.f90 to fix compiling error using AIX 5.3.0 (MSB 7/29/2008)
-        - Fixed missing commas in H5test_kind.f90 detected by NAG compiler (MSB 7/29/2008)
-        - Fixed passing and array to a scalar in tH5A_1_8.f90 detected by 
-           NAG compiler (MSB 7/29/2008)
-	- Added the ability of the test programs to use the status of HDF5_NOCLEANUP to
-	   determine if the *.h5 files should be removed or not after the tests are 
-           completed (MSB 10/1/2008)
-	- In nh5tget_offset_c: (MSB 9/12/2008)
-           If offset was equal to 0 it returned the error code of -1, this was changed to return 
-	   an error code of -1 when the offset value is < 0.
-        - Uses intrinsic Fortran function SIZEOF if available when detecting type of INTEGERs
-           and REALs in H5test_kind.f90 (MSB 9/3/2008)
-        - Put the DOUBLE PRECISION interfaces in a separate module and added a USE statement for 
-           the module. The interfaces are included/excluded depending on
-           the state of FORTRAN_DEFAULT_REALisDBLE_F which detects if the default REAL 
-           is DOUBLE PRECISION. This allows the library to be compiled with -r8 Fortran flag 
-           without the user needing to edit the source code. (MSB 8/27/2008)
-        - Enable building shared library for fortran by adding the flag -fPIC to the compile 
-           flags for versions of Intel Fortran compiler >=9  (MSB 8/26/2008)
-
-        C++ API
-        ------
-        - None
+
+
+    Documentation 
+    ------------- 
+
+
+    F90 APIs
+    --------
+
+
+    C++ APIs
+    --------
+        - Fixed bug that caused segfaults in Attribute::read. (BMR - 2008/04/20)
+        - Fixed bug in PropList::getClassName to use portable HDfree instead
+            of free. (BMR - 2008/04/20)
+        - Fixed a design bug which allowed an Attribute object to create/modify
+          attributes (bugzilla #1068).  The API class hierarchy was revised
+          to address the problem.  Classes AbstractDS and Attribute are moved
+          out of H5Object.  Class Attribute now multiply inherits from
+          IdComponent and AbstractDs and class DataSet from H5Object and
+          AbstractDs.  In addition, the data member IdComponent::id was
+          moved into subclasses: Attribute, DataSet, DataSpace, DataType,
+          H5File, Group, and PropList. (BMR - 2008/08/10)
+        - IdComponent::dereference was incorrect and replaced as described
+          in "New Features" section.
+          (BMR - 2008/08/10)
+
 
 
 Platforms Tested
 ================
-The following platforms and compilers have been tested for this release.
-
-    Cray XT3 (2.0.41)             cc (pgcc) 7.1-4
-    (red storm)                   ftn (pgf90) 7.1-4
-				  CC (pgCC) 7.1-4
-                                  mpicc 1.0.2
-                                  mpif90 1.0.2
 
+    AIX 5.2 (32/64 bit)           xlc 8.0.0.11
+                                  xlC 8.0
+                                  xlf 10.01.0000.0 
+                                  mpcc_r 6.0.0.8
+                                  mpxlf_r 8.1.1.7
     FreeBSD 6.2-STABLE i386       gcc 3.4.6 [FreeBSD] 20060305
     (duty)                        g++ 3.4.6 [FreeBSD] 20060305
                                   gcc 4.2.1 20080123
                                   g++ 4.2.1 20080123
                                   gfortran 4.2.1 20070620
-
     FreeBSD 6.2-STABLE amd64      gcc 3.4.6 [FreeBSD] 20060305
     (liberty)                     g++ 3.4.6 [FreeBSD] 20060305
                                   gcc 4.2.1 20080123
@@ -244,63 +263,49 @@ The following platforms and compilers have been tested for this release.
     IRIX64 6.5 (64 & n32)         MIPSpro cc 7.4.4m
                                   F90 MIPSpro 7.4.4m 
                                   C++ MIPSpro cc 7.4.4m
-
+				 
     Linux 2.6.9 (RHEL4)           Intel 10.0 compilers
     (abe.ncsa.uiuc.edu)
-
     Linux 2.4.21-47               gcc 3.2.3 20030502
     (osage)
-
-    Linux 2.6.9-42.0.10           gcc,g++ 3.4.6 20060404, G95 (GCC 4.0.3) 
-    (kagiso)                      PGI 7.1-6 (pgcc, pgf90, pgCC)
+    Linux 2.6.9-42.0.10           gcc 3.4.6 20060404
+    (kagiso)                      PGI 7.0-7 (pgcc, pgf90, pgCC)
                                   Intel 9.1 (icc, ifort, icpc)
-
-    Linux 2.6.16.27 x86_64 AMD    gcc 4.1.0 (SuSE Linux), g++ 4.1.0, 
-    (smirom)                          g95 (GCC 4.0.3)
-                                  PGI 7.2-1 (pgcc, pgf90, pgCC)
-                                  Intel 10.1 (icc, ifort, icpc)
-
-    Linux 2.6.5-7.252.1-rtgfx #1  Intel(R) C++ Version 9.0
-          SMP ia64                Intel(R) Fortran Itanium(R) Version 9.0 
-    (cobalt)                      SGI MPI
-
+    Linux 2.6.16.27 x86_64 AMD    gcc 4.1.0 (SuSE Linux), g++ 4.1.0, g95 (GCC 4.0.3)
+    (smirom)                      PGI 6.2-5 (pgcc, pgf90, pgCC)
+                         	  Intel 9.1 (icc, iort, icpc)
+    Linux 2.6.5-7.252.1-rtgfx #1 
+          SMP ia64                Intel(R) C++ Version 9.0
+    (cobalt)                      Intel(R) Fortran Itanium(R) Version 9.0 
+                                  SGI MPI
     SunOS 5.8 32,46               Sun WorkShop 6 update 2 C 5.3
      (Solaris 2.8)                Sun WorkShop 6 update 2 Fortran 95 6.2
                                   Sun WorkShop 6 update 2 C++ 5.3
-
     SunOS 5.10                    cc: Sun C 5.8 
     (linew)                       f90: Sun Fortran 95 8.2 
                                   CC: Sun C++ 5.8 
-
     Xeon Linux 2.4.21-32.0.1.ELsmp-perfctr-lustre
-    (tungsten)                    gcc 3.2.2 20030222
+    (tungsten)	                  gcc 3.2.2 20030222
                                   Intel(R) C++ Version 9.0
                                   Intel(R) Fortran Compiler Version 9.0
-
-    IA-64 Linux 2.4.21.SuSE_309.tg1 ia64
+    IA-64 Linux 2.4.21.SuSE_292.til1 ia64
     (NCSA tg-login)               gcc 3.2.2
                                   Intel(R) C++ Version 8.1
                                   Intel(R) Fortran Compiler Version 8.1
-                                  mpich-gm-1.2.6..14b-intel-r2
-
-    Intel 64 Linux 2.6.9-42.0.10.EL_lustre-1.4.10.1smp
-    (abe)                         gcc 3.4.6 20060404
-                                  Intel(R) C++ Version 10.0
-                                  Intel (R) Fortran Compiler Version 10.0
-                                  mvapich2-0.9.8p2patched-intel-ofed-1.2
-
-    Windows XP                    Visual Studio .NET
+				  mpich-gm-1.2.5..10-intel-r2
+    Windows XP                    
+				  Visual Studio .NET
                                   Visual Studio 2005 w/ Intel Fortran 9.1
                                   Cygwin(native gcc compiler and g95)
-                                  MinGW(native gcc compiler and g95)
-
-    Windows XP x64                Visual Studio 2005 w/ Intel Fortran 9.1
-
-    Windows Vista                 Visual Studio 2005
+				  MinGW(native gcc compiler and g95)
+    Windows XP x64                
+			          Visual Studio 2005 w/ Intel Fortran 9.1
+    Windows Vista			
+			          Visual Studio 2005
 
-    MAC OS  10.5.2 (Intel)        i686-apple-darwin9-gcc-4.0.1 (GCC) 4.0.1
-                                  GNU Fortran (GCC) 4.3.0 20070810
-                                  G95 (GCC 4.0.3 (g95 0.91!) Apr 24 2008)
+    MAC OS  10.4 (Intel)          gcc i686-apple-darwin8-gcc-4.0.1 (GCC) 4.0.1 
+                                  G95 (GCC 4.0.3 (g95 0.91!) Nov 21 2006)
+    Alpha Open VMS 7.3
 
 
 Supported Configuration Features Summary
@@ -310,215 +315,193 @@ Supported Configuration Features Summary
           y   = tested and supported
           n   = not supported or not tested in this release
           x   = not working in this release
-          dna = does not apply
           ( ) = footnote appears below second table
-          <blank> = testing incomplete on this feature or platform 
-
-Platform                 C        F90    F90      C++   zlib  SZIP
-                         parallel        parallel
-SunOS5.10 64-bit         n        y      n        y     y     y
-SunOS5.10 32-bit         n        y      n        y     y     y
-IRIX64_6.5 64-bit        n        y      y        y     y     y
-IRIX64_6.5 32-bit        n        n      n        n     y     y
-Windows XP               n        y(15)  n(15)    y     y     y
-Windows XP x64           n        y(15)  n(15)    y     y     y
-Windows Vista            n        n      n        y     y     y
-Mac OS X 10.5 Intel      n        y      n        y     y     y
-FreeBSD 4.11             n        n      n        y     y     y
-RedHat EL3  W       (3)  y(1)     y(10)  y(1)     y     y     y
-RedHat EL3  W Intel (3)  n        y      n        y     y     n
-RedHat EL3  W PGI   (3)  n        y      n        y     y     n
-SuSe x86_64 gcc  (3,12)  y(2)     y(11)  y(2)     y     y     y
-SuSe x86_64 Int  (3,12)  n        y(13)  n        y     y     n
-SuSe x86_64 PGI  (3,12)  n        y(8)   n        y     y     y
-Linux 2.4 Xeon C 
-    Lustre Intel  (3,6)  n        y      n        y     y     n
-Linux 2.6 SuSE ia64 C 
-    Intel         (3,7)  y        y      y        y     y     n
-Linux 2.6 SGI Altix 
-    ia64 Intel      (3)  y        y      y        y     y     y
-Linux 2.6 RHEL C
-    Lustre Intel    (5)  y(4)     y      y(4)     y     y     n
-Cray XT3 2.0.41          y        y      y        y     y     n
-
-
-Platform                 Shared  Shared    Shared    Thread-  
-                         C libs  F90 libs  C++ libs  safe     
-Solaris2.10 64-bit       y       y         y         y        
-Solaris2.10 32-bit       y       y         y         y        
-IRIX64_6.5 64-bit        y       y         n         y        
-IRIX64_6.5 32-bit        y       dna       y         y        
-Windows XP               y       y(15)     y         y        
-Windows XP x64           y       y(15)     y         y        
-Windows Vista            y       n         n         y        
-Mac OS X 10.3            y                           n        
-FreeBSD 4.11             y       n         y         y        
-RedHat EL3  W       (3)  y       y(10)     y         y        
-RedHat EL3  W Intel (3)  y       y         y         n        
-RedHat EL3  W PGI   (3)  y       y         y         n        
-SuSe x86_64 W GNU (3,12) y       y         y         y        
-SuSe x86_64 W Int (3,12) y       y         y         n        
-SuSe x86_64 W PGI (3,12) y       y         y         n        
-Linux 2.4 Xeon C 
-    Lustre Intel    (6)  y       y         y         n        
-Linux 2.4 SuSE 
-    ia64 C Intel    (7)  y       y         y         n        
-Linux 2.4 SGI Altix 
-    ia64 Intel           y                           n        
-Linux 2.6 RHEL C
-    Lustre Intel    (5)  y        y        y         n
-Cray XT3 2.0.41          n       n         n         n        n
-
-    Notes: (1)  Using mpich2 1.0.6.
-           (2)  Using mpich2 1.0.7.
-           (3)  Linux 2.6 with GNU, Intel, and PGI compilers, as indicated.  
-                  W or C indicates workstation or cluster, respectively.
-           (4)  Using mvapich2 0.9.8.
-           (5)  Linux 2.6.9-42.0.10.  Xeon cluster with ELsmp_perfctr_lustre 
-                  and Intel compilers
-           (6)  Linux 2.4.21-32.0.1.  Xeon cluster with ELsmp_perfctr_lustre 
-                  and Intel compilers
-           (7)  Linux 2.4.21, SuSE_292.till.  Ia64 cluster with Intel compilers
-           (8)  pgf90
-           (9)  With Compaq Visual Fortran 6.6c compiler.
-           (10) With PGI and Absoft compilers.
-           (11) PGI and Intel compilers for both C and Fortran
-           (12) AMD Opteron x86_64
-           (13) ifort
-           (14) Yes with C and Fortran, but not with C++
-           (15) Using Visual Studio 2005 or Cygwin
-           (16) Not tested for this release.
+          <blank> = testing incomplete on this feature or platform
+          W or C indicates workstation or cluster, respectively.
+
+Platform                          C        F90    F90      C++   zlib  SZIP
+                                  parallel        parallel
+SunOS5.8 64-bit                    n        y      n        y     y     y
+SunOS5.8 32-bit                    n        y      n        y     y     y
+SunOS5.10 64-bit                   n        y      n        y     y     y
+SunOS5.10 32-bit                   n        y      n        y     y     y
+IRIX64_6.5 64-bit                  n        y      y        y     y     y
+IRIX64_6.5 32-bit                  n        n      n        n     y     y
+AIX-5.2  32-bit                    y        y      y        y     y     y
+AIX-5.2  64-bit                    y        y      y        y     y     y
+Cray XT3 (not tested
+          for this release)        n        n      n        n     n     n
+Windows XP                         n        y(3)   n(3)     y     y     y
+Windows XP x64                     n        y(3)   n(3)     y     y     y
+Windows Vista                      n        n      n        y     y     y
+Mac OS X 10.4 PowerPC              n               n
+Mac OS X 10.4 Intel                n        y      n        y     y     y
+FreeBSD 6.2 32-bit                 n        n      n        y     y     y
+FreeBSD 6.2 64-bit
+RedHat EL4 2.6.9 i686 GNU        W y(2)     y(4)   y(2)     y     y     y
+RedHat EL4 2.6.9 i686 Intel      W n        y      n        y     y     n
+RedHat EL4 2.6.9 i686 PGI        W n        y      n        y     y     n
+SuSe Linux 2.6.16 x86_64 GNU (5) W y(2)     y      n        y     y     y
+SuSe Linux 2.6.16 x86_64 Int (5) W n        y      n        y     n     n
+SuSe Linux 2.6.16 x86_64 PGI (5) W n        y      n        y     n     n
+RHL9 Linux 2.4 Xeon Lustre Intel C n        y      n        y     y     n
+RHEL3 Linux 2.4 Xeon Intel       W n        y      n        n     y     n
+RHEL4 Linux 2.6 Xeon Lustre Int  C n        y      n        y     y     n
+SuSE Linux 2.4 ia64 Intel        C y(1)     y      y        y     y     y
+SuSe Linux 2.6.5
+       SGI Altix ia64 Intel      C n        y      n        y     n     y
+Alpha OpenVMS 7.3.2                n        y      n        y     n     n
+
+
+
+Platform                          Shared   Shared    Shared    static-  Thread-
+                                  C libs   F90 libs  C++ libs  exec     safe
+SunOS 5.8 32-bit                    y        y         y         x        y
+SunOS 5.8 64-bit                    y        y         y         x        y
+SunOS 5.10 32-bit                   y        y         y         x        y
+SunOS 5.10 64-bit                   y        y         y         x        y
+IRIX64_6.5 32-bit                   y        n         y         x        y
+IRIX64_6.5 64-bit                   y        y         n         x        y
+AIX-5.2 32-bit                      n        n         n         x        n
+AIX-5.2 64-bit                      n        n         n         x        n
+Cray XT3 (not tested
+          for this release)         n        n         n         x        n
+Windows XP                          y        y(3)      y         y        y
+Windows XP x64                      y        y(3)      y         y        y
+Windows Vista                       y        n         n         y        y
+Mac OS X 10.4 Intel Duo             y        y         y         x        n
+FreeBSD 6.2 32-bit                  y        y         y         x        n
+FreeBSD 6.2 64-bit                  y        y         y         x        n
+RHEL4 2.6.9 i686 GNU              W y        y(4)      y         x        y
+RHEL4 2.6.9 i686 Intel            W y        y         y         x        n
+RHEL4 2.6.9 i686 PGI              W y        y         y         x        n
+SuSE Linux 2.6.16 x86_64 GNU (5)  W y        y         y         x        y
+SuSE Linux 2.6.16 x86_64 Intel(5) W y        y         y         x        n
+SuSE Linux 2.6.16 x86_64 PGI(5)   W y        y         y         x        n
+RHL9 Linux 2.4 Xeon Lustre Intel  C y        y         y         x        n
+RHEL3 Linux 2.4 Xeon Intel        W y        n         n         x        n
+RHEL4 Linux 2.6 Xeon Lustre Intel C y        y         y         x        n
+SuSE Linux 2.4 ia64 Intel         C y        y         y         x        n
+SuSe Linux 2.6.5
+           SGI Altix ia64 Intel   C n        n         n         x        n
+
+    Notes: (1)  Using mpich 1.2.6.
+           (2) Using mpich2 1.0.6.
+           (3) Using Visual Studio 2005 or Cygwin
+           (4) With PGI and Absoft compilers.
+           (5) AMD Opteron x86_64
     Compiler versions for each platform are listed in the preceding
     "Platforms Tested" table.
 
 
+
 Known Problems
 ==============
-* For Red Storm, a Cray XT3 system, the yod command sometimes gives the
-  message,  "yod allocation delayed for node recovery".  This interferes with
-  test suites that do not expect seeing this message.  See the section of "Red
-  Storm" in file INSTALL_parallel for a way to deal with this problem.
-  AKC - 2008/05/28
-
-* For Red Storm, a Cray XT3 system, the tools/h5ls/testh5ls.sh will fail on
-  the test "Testing h5ls -w80 -r -g tgroup.h5" fails.  This test is
-  expected to fail and exit with a non-zero code but the yod command does
-  not propagate the exit code of the executables. Yod always returns 0 if it
-  can launch the executable.  The test suite shell expects a non-zero for
-  this particular test, therefore it concludes the test has failed when it
-  receives 0 from yod.  To bypass this problem for now, change the following
-  lines in the tools/h5ls/testh5ls.sh.
-  ======== Original =========
-  # The following combination of arguments is expected to return an error message
-  # and return value 1
-  TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5
-  ======== Skip the test =========
-  echo SKIP TOOLTEST tgroup-1.ls 1 -w80 -r -g tgroup.h5
-  ======== end of bypass ========
-  AKC - 2008/05/28
-
-* We have discovered two problems when running collective IO parallel HDF5 
-  tests with chunking storage on the ChaMPIon MPI compiler on tungsten, a 
-  Linux cluster at NCSA.
-
-  Under some complex selection cases: 
+* We discovered two problems when running collective IO parallel HDF5 tests 
+  with chunking storage on  ChaMPIon MPI compiler on tungsten, a linux 
+  cluster at NCSA.
+  Under some complex selection cases, 
   1) MPI_Get_element returns the wrong value.
-  2) MPI_Type_struct also generates the wrong derived datatype and corrupt 
-     data may be generated.
-  These issues arise only when turning on collective IO with chunking storage 
-  with some complex selections. We have not found these problems on other 
-  MPI-IO compilers. If you encounter these problems, you may use independent 
-  IO instead.
-
-  To avoid this behavior, change the following line in your code
-      H5Pset_dxpl_mpio(xfer_plist, H5FD_MPIO_COLLECTIVE);
+  2) MPI_Type_struct also generates wrong derived data type and corrupt data
+     may be generated.
+  This only happens when turning on collective IO with chunking storage 
+  with some complex selections. We haven't found these problems on other
+  MPI-IO compilers. If you encounter these problems, you may use Independent IO
+  instead.
+
+  Change the following line in your code:
+  H5Pset_dxpl_mpio(xfer_plist, H5FD_MPIO_COLLECTIVE);
+
   to
-      H5Pset_dxpl_mpio(xfer_plist, H5FD_MPIO_INDEPENDENT);
+  H5Pset_dxpl_mpio(xfer_plist, H5FD_MPIO_INDEPENDENT);
 
   KY - 2007/08/24
 
 * For SNL, spirit/liberty/thunderbird: The serial tests pass but parallel
-  tests failed with MPI-IO file locking message. AKC - 2007/6/25
-
-* On Intel 64 Linux cluster (RH 4, Linux 2.6.9) with Intel 10.0 compilers, 
-  use -mp -O1 compilation flags to build the libraries. A higher level of 
-  optimization causes failures in several HDF5 library tests. 
-
-* For LLNL, uP: both serial and parallel tests pass.  
-  Zeus: Serial tests pass but parallel tests fail with a known problem in MPI.
-  ubgl: Serial tests pass but parallel tests fail. 
-
-* Configuring with --enable-debug=all produces compiler errors on most
-  platforms:  Users who want to run HDF5 in debug mode should use
+  tests failed with MPI-IO file locking message. AKC - 2007/6/25.
+* On Intel 64 Linux cluster (RH 4, Linux 2.6.9) with Intel 10.0 compilers use
+  -mp -O1 compilation flags to build the libraries. Higher level of optimization 
+  causes failures in several HDF5 library tests. 
+* For HPUX 11.23 many tools tests failed for 64-bit version when linked to the
+  shared libraries (tested for 1.8.0-beta2)
+* For SNL, Red Storm: only paralle HDF5 is supported.  The serial tests pass
+  and the parallel tests also pass with lots of non-fatal error messages.
+* For LLNL, uP: both serial and parallel pass.  Zeus: serial passes but
+  parallel fails with a known proglem in MPI.  ubgl: serial passes but
+  parallel fails. 
+* on SUN 5.10 C++ test fails in the "Testing Shared Datatypes with Attributes" test 
+* configuring with --enable-debug=all produces compiler errors on most
+  platforms.  Users who want to run HDF5 in debug mode should use
   --enable-debug rather than --enable-debug=all to enable debugging
   information on most modules.
-
 * On Mac OS 10.4, test/dt_arith.c has some errors in conversion from long
-  double to (unsigned) long long and from (unsigned) long long to long double. 
-+       - Fixed assertion failure caused by incorrect array datatype version.
-+             (NAF - 2008/08/04)
-* On Altix SGI with Intel 9.0, testmeta.c would not compile with -O3
+  double to (unsigned) long long and from (unsigned)long long to long double. 
+* On Altix SGI with Intel 9.0 testmeta.c would not compile with -O3
   optimization flag.
-
-* On VAX, the Scaleoffset filter is not supported.  The Scaleoffset filter 
-  supports only the IEEE standard for floating-point data; it cannot be applied 
-  to HDF5 data generated on VAX. 
-
+* On VAX, Scaleoffset filter isn't supported. The filter cannot be applied to
+  HDF5 data generated on VAX. Scaleoffset filter only supports IEEE standard
+  for floating-point data.
 * On Cray X1, a lone colon on the command line of h5dump --xml (as in
   the testh5dumpxml.sh script) is misinterpereted by the operating system
   and causes an error.
-
-* On mpich 1.2.5 and 1.2.6, if more than two processes contribute no IO and 
-  the application asks to do collective IO, we have found that when using 4 
-  processors, a simple collective write will sometimes be hung. This can be 
-  verified with t_mpi test under testpar.
-
-* On IRIX6.5, when the C compiler version is greater than 7.4, complicated
-  MPI derived datatype code will work. However, the user should increase
-  the value of the MPI_TYPE_MAX environment variable to some appropriate value 
-  to use collective irregular selection code.  For example, the current 
-  parallel HDF5 test needs to raise MPI_TYPE_MAX to 200,000 to pass the test. 
-
-* A dataset created or rewritten with a v1.6.3 library or after cannot be read 
-  with the v1.6.2 library or before when the Fletcher32 EDC filter is enabled.
-  There was a bug in the calculation of the Fletcher32 checksum in the 
-  library before v1.6.3; the checksum value was not consistent between big-
-  endian and little-endian systems.  This bug was fixed in Release 1.6.3.  
-  However, after fixing the bug, the checksum value was no longer the same as 
-  before on little-endian system.  Library releases after 1.6.4 can still read 
-  datasets created or rewritten with an HDF5 library of v1.6.2 or before.  
-  SLU - 2005/6/30
-
-* For version 6 (6.02 and 6.04) of the Portland Group compiler on the AMD 
-  Opteron processor, there is a bug in the compiler for optimization(-O2).  
-  The library failed in several tests, all related to the MULTI driver.  
-  The problem has been reported to the vendor.  
-
+* On mpich 1.2.5 and 1.2.6, we found that if more than two processes
+  contribute no IO and the application asks to do IO with collective, we found
+  that when using 4 processors, a simple collective write will be hung
+  sometimes. This can be verified with t_mpi test under testpar.
+* On IRIX6.5, when C compiler version >7.4, the complicate MPI derived data type
+  code will work. However, the user should be aware to enlarge MPI_TYPE_MAX environment 
+  variable to some certian value in order to use collective irregular selection code.
+  For example, the current parallel HDF5 test needs to enlarge MPI_TYPE_MAX to 
+  200,000 to make the test pass.
+* The dataset created or rewritten with the v1.6.3 library or after can't 
+  be read with the v1.6.2 library or before when Fletcher32 EDC(filter) is 
+  enabled.  There was a bug in the calculating code of the Fletcher32 
+  checksum in the library before v1.6.3.  The checksum value wasn't consistent 
+  between big-endian and little-endian systems.  This bug was fixed in 
+  Release 1.6.3.  However, after fixing the bug, the checksum value is no 
+  longer the same as before on little-endian system.  The library release 
+  after 1.6.4 can still read the dataset created or rewritten with the library
+  of v1.6.2 or before.  SLU - 2005/6/30
+* For the version 6(6.02 and 6.04) of Portland Group compiler on AMD Opteron
+  processor, there's a bug in the compiler for optimization(-O2).  The library
+  failed in several tests but all related to multi driver.  The problem has 
+  been reported to the vendor.  
 * On IBM AIX systems, parallel HDF5 mode will fail some tests with error
-  messages like "INFO: 0031-XXX ...".  This is from the command `poe'.
+  messages like "INFO: 0031-XXX ...".  This is from the command poe.
   Set the environment variable MP_INFOLEVEL to 0 to minimize the messages
   and run the tests again.
-
-  The tests may fail with messages like "The socket name is already in use",  
-  but HDF5 does not use sockets.  This failure is due to problems with the 
-  poe command trying to set up the debug socket.  To resolve this problem, 
-  check to see whether there are many old /tmp/s.pedb.* files staying around.  
-  These are sockets used by the poe command and left behind due to failed 
-  commands.  First, ask your system administrator to clean them out.  
-  Lastly, request IBM to provide a means to run poe without the debug socket.
+  The tests may fail with messages like "The socket name is already
+  in use".  HDF5 does not use sockets (except for stream-VFD).  This is
+  due to problems of the poe command trying to set up the debug socket.
+  Check if there are many old /tmp/s.pedb.* staying around.  These are
+  sockets used by the poe command and left behind due to failed commands.
+  Ask your system administrator to clean them out.  Lastly, request IBM
+  to provide a mean to run poe without the debug socket.
+
+* The C++ library's tests fails when compiling with PGI C++ compiler.  The
+  workaround until the problem is correctly handled is to use the 
+  flag "--instantiate=local" prior to the configure and build steps, as:
+        setenv CXX "pgCC --instantiate=local"  for pgCC 5.02 and higher
+
+
+* The stream-vfd test uses ip port 10007 for testing. If another
+  application is already using that port address, the test will hang
+  indefinitely and has to be terminated by the kill command. To try the
+  test again, change the port address in test/stream_test.c to one not
+  being used in the host.
 
 * The --enable-static-exec configure flag fails to compile for Solaris
-  platforms. This is due to the fact that not all of the system libraries on 
-  Solaris are available in a static format.
+  platforms. This is due to the fact that not all of the system
+  libraries on Solaris are available in a static format.
 
   The --enable-static-exec configure flag also fails to correctly compile
-  on IBM SP2 platforms for serial mode. The parallel mode works fine with 
-  this option.
+  on IBM SP2 platform for the serial mode. The parallel mode works fine
+  with this option.
   
-  It is suggested that you do not use this option on these platforms
+  It is suggested that you don't use this option on these platforms
   during configuration.
 
-* With the gcc 2.95.2 compiler, HDF5 uses the `-ansi' flag during
+* With the gcc 2.95.2 compiler, HDF 5 uses the `-ansi' flag during
   compilation. The ANSI version of the compiler complains about not being
   able to handle the `long long' datatype with the warning:
 
@@ -526,29 +509,39 @@ Known Problems
   
   This warning is innocuous and can be safely ignored.
 
-* The ./dsets tests fail on the TFLOPS machine if the test program,
-  dsets.c, is compiled with the -O option.  The HDF5 library still works
+
+* The Stream VFD was not tested yet under Windows. It is not supported
+  in the TFLOPS machine.
+
+
+* The ./dsets tests failed in the TFLOPS machine if the test program,
+  dsets.c, is compiled with the -O option.  The hdf5 library still works
   correctly with the -O option.  The test program works fine if it is
   compiled with -O1 or -O0.  Only -O (same as -O2) causes the test
   program to fail.
 
-* Not all platforms behave correctly with Szip's shared libraries. Szip is
-  disabled in these cases, and a message is relayed at configure time. Static
-  libraries should be working on all systems that support Szip and should be
-  used when shared libraries are unavailable. 
+* Certain platforms give false negatives when testing h5ls:
+    - Cray J90 and Cray T90IEEE give errors during testing when displaying
+      some floating-point values. These are benign differences due to
+      the different precision in the values displayed and h5ls appears to
+      be dumping floating-point numbers correctly.
 
-  There is also a configure error on Altix machines that incorrectly reports 
-  when a version of Szip without an encoder is being used.
+* Not all platforms behave correctly with szip's shared libraries. Szip is
+  disabled in these cases, and a message is relayed at configure time. Static
+  libraries should be working on all systems that support szip, and should be
+  used when shared libraries are unavailable. There is also a configure error
+  on Altix machines that incorrectly reports when a version of szip without
+  an encoder is being used.
 
-* On some platforms that use Intel and Absoft compilers to build the HDF5 
-  Fortran library, compilation may fail for fortranlib_test.f90, fflush1.f90 
-  and fflush2.f90 complaining about the exit subroutine. Comment out the line 
-  IF (total_error .ne. 0) CALL exit (total_error).
+* On some platforms that use Intel and Absoft compilers to build HDF5 fortran library,
+  compilation may fail for fortranlib_test.f90, fflush1.f90 and fflush2.f90
+  complaining about exit subroutine. Comment out the line 
+  IF (total_error .ne. 0) CALL exit (total_error)
 
 * Information about building with PGI and Intel compilers is available in
-  the INSTALL file sections 4.7 and 4.8.
+  INSTALL file sections 5.7 and 5.8
 
-* On at least one system, SDSC DataStar, the scheduler (in this case
+* On at least one system, (SDSC DataStar), the scheduler (in this case
   LoadLeveler) sends job status updates to standard error when you run 
   any executable that was compiled with the parallel compilers.
 
@@ -583,21 +576,21 @@ Known Problems
 
         ($* > $STDOUT_FILE) >& $STDERR_FILE
 
-        set RETURN_VALUE=$status
+	set RETURN_VALUE=$status
 
         cat $STDOUT_FILE
 
         tail +3 $STDERR_FILE
 
-        exit $RETURN_VALUE
+	exit $RETURN_VALUE
 
-  You get the HDF5 make files and test scipts to execute your filter script
+  You get the HDF make files and test scipts to execute your filter script
   by setting the environment variable "RUNSERIAL" to the full path of the 
   script prior to running configure for parallel builds.  Remember to 
   "unsetenv RUNSERIAL" before running configure for a serial build.
 
   Note that the RUNSERIAL environment variable exists so that we can 
-  prefix serial runs as necessary on the target system.  On DataStar,
+  can prefix serial runs as necessary on the target system.  On DataStar,
   no prefix is necessary.  However on an MPICH system, the prefix might
   have to be set to something like "/usr/local/mpi/bin/mpirun -np 1" to
   get the serial tests to run at all.
@@ -607,10 +600,5 @@ Known Problems
 
 * H5Ocopy() does not copy reg_ref attributes correctly when shared-message
   is turn on. The value of the reference in the destination attriubte is
-  wrong. This H5Ocopy problem will affect the h5copy tool.
-
-* In the C++ API, it appears that there are bugs in Attribute::write/read
-  and DataSet::write/read for fixed- and variable-len strings.  The problems
-  are being worked on and a patch will be provided when the fixes are
-  available.
+  wrong. This H5Ocopy problem will affect h5copy tool