[svn-r5722] Snapshot version 1.4 release 4 (pre5)

1 files changed, 102 insertions, 40 deletions

diff --git a/doc/html/ADGuide/RELEASE.txt b/doc/html/ADGuide/RELEASE.txt
index f369030..9bee3a3 100644
--- a/doc/html/ADGuide/RELEASE.txt
+++ b/doc/html/ADGuide/RELEASE.txt
@@ -1,4 +1,4 @@
-HDF5 version 1.4.4-pre3 released on Wed Jun 19 15:37:34 CDT 2002
+HDF5 version 1.4.4-pre5 released on Thu Jun 27 13:33:35 CDT 2002
 ==============================================================================
 
 
@@ -27,6 +27,7 @@ CONTENTS
 
 - New Features
 - Bug Fixes since HDF5-1.4.3
+- Performance Improvements
 - Documentation
 - Platforms Tested
 - Supported Configuration Features
@@ -37,24 +38,21 @@ New Features
 ============
   o Configuration
   ================
+    * The H4 to H5 tools were removed from the main source and placed in a
+      separate package. You can get these tools from the HDF ftp site
+	  (ftp://hdf.ncsa.uiuc.edu/). The "--with-hdf4" command-line option during
+      configure is no longer valid.  BW - 2002/06/25
+
 
   o Library
   =========
     o General
     --------- 
-      * Added internal "small data" aggregation, which can reduce the number of
-        actual I/O calls made, improving performance.  QAK - 2002/06/05
-      * Improved internal metadata aggregation, which can reduce the number of
-        actual I/O calls made, improving performance.  Additionally, this can
-        reduce the size of files produced.  QAK - 2002/06/04
-      * Improved internal metadata caching, which can reduce the number of
-        actual I/O calls made by a substantial amount, improving
-        performance.  QAK - 2002/06/03
       * Fill-value's forward-compatibility with 1.5 was added.  SLU -
-	2002/04/11
+        2002/04/11
       * A new query function H5Tget_member_index has been added for compound
-	and enumeration data types, to retrieve member's index by name.
-	SLU - 2002/04/05
+        and enumeration data types, to retrieve member's index by name.
+        SLU - 2002/04/05
       * Added serial multi-gigabyte file size test.  "test/big -h" shows
         the help page.  AKC - 2002/03/29
  
@@ -68,9 +66,21 @@ New Features
  
     o Performance
     -------------
+      * Added internal "small data" aggregation, which can reduce the number of
+        actual I/O calls made, improving performance.  QAK - 2002/06/05
+      * Improved internal metadata aggregation, which can reduce the number of
+        actual I/O calls made, improving performance.  Additionally, this can
+        reduce the size of files produced.  QAK - 2002/06/04
+      * Improved internal metadata caching, which can reduce the number of
+        actual I/O calls made by a substantial amount, improving
+        performance.  QAK - 2002/06/03
+
 
   o Parallel Library
   ==================
+    * Fixed bug in parallel I/O routines where a collective I/O which used
+      MPI derived types, followed by an independent I/O would cause the library
+      to hang.  QAK 2002/06/24
     * Added environment variable flag to control whether creating MPI derived
       typed is preferred or not.  This can affect performance, depending on
       which way the MPI-I/O library is optimized for.  The default is set to
@@ -103,8 +113,21 @@ New Features
 
   o Support for new platforms and languages
   =========================================
-      * Parallel Fortran Library works now on HP-UX B.11.00 Sys V
-        EIP - 2002/05/06
+    * Parallel Fortran Library works now on HP-UX B.11.00 Sys V
+      EIP - 2002/05/06
+    * Intel C++ and F90 compilers Version 6.0 are supported on Linux 2.4
+    * Intel C++ compilers Version 6.0 are supported on windows 2000
+
+  
+  o Misc.
+  =========================================
+   * zlib is moved out of windows source release. Users should go to
+     HDF homepage(URL: http://???) to download the corresponding zlib library.
+   * Windows binary release is built with the old version of zlib library.
+     We expect users to use zlib 1.1.4 to build with source release.  
+   * In windows-specified install document, we specify how to test backward
+     compatibility. However, in this release, we are not testing the backward
+     compatibility of HDF5.
 
 
 Bug Fixes since HDF5-1.4.3 Release
@@ -130,7 +153,7 @@ Bug Fixes since HDF5-1.4.3 Release
     * Clear symbol table node "dirty" flag when flushing symbol tables to
         disk, to reduce I/O calls made & improve performance.  QAK - 2002/06/03
     * Fixed bug where an object's header could get corrupted in certain
-        obscure situations where many objects were created in the
+        obscure situations when many objects were created in the
         file.  QAK - 2002/05/31
         was not being kept the same as the original file.  QAK - 2002/05/14
     * Fixed bug where read/write intent in file IDs created with H5Freopen
@@ -155,6 +178,27 @@ Bug Fixes since HDF5-1.4.3 Release
         conversion buffer is attempted to be read.  QAK - 2002/03/26
 
 
+Performance Improvements
+========================
+    This release of the HDF5 library has been extensively tuned to improve
+performance, especially to improve parallel I/O performance.
+    Most of the specific information for particular performance improvements
+is mentioned in the "New Features" and "Bug Fixes Since HDF5-1.4.3" sections
+of this document, but in general, the library should make fewer and larger
+I/O requests when accessing a file.  Additionally, improvements to the parallel
+I/O portions of the library should have reduced the communications and barriers
+used in various internal algorithms, improving the performance of the library.
+    However, with the extensive changes to some portions of the library that
+were required for these improvements, some errors or unanticipated results may
+have been introduced also.  Please report any problems encountered to our
+support team at hdfhelp@ncsa.uiuc.edu.
+    Hopefully these improvements will benefit all HDF5 applications, but if
+there are particular I/O patterns that appear to be slower than necessary,
+please send e-mail to hdfhelp@ncsa.uiuc.edu with a sample program showing the
+problem behavior and we will look into the issue to see if it is possible to
+address it.
+
+
 Documentation
 =============
 
@@ -169,12 +213,15 @@ Platforms Tested
     AIX 4.3 (IBM SP RS6000)       C for AIX Compiler, Version 5.0.2.0
                                   xlf 7.1.0.2
                                   poe 3.1.0.12 (includes mpi)
+    AIX 5.1                       xlc 5.0.2.0 
+                                  xlf 07.01.0000.0002
+                                  mpcc_r 5.0.2.0; mpxlf_r 07.01.0000.0002
     Cray T3E sn6711 2.0.5.57      Cray Standard C Version 6.5.0.3
                                   Cray Fortran Version 3.5.0.4
-    Cray SV1 10.0.0.8             Cray Standard C Version 6.5.0.3 
+    Cray SV1 10.0.1.1             Cray Standard C Version 6.5.0.3 
                                   Cray Fortran Version 3.5.0.4
-    FreeBSD 4.5                   gcc 2.95.3
-                                  g++ 2.95.3
+    FreeBSD 4.6                   gcc 2.95.4
+                                  g++ 2.95.4
     HP-UX B.10.20                 HP C  HP92453-01 A.10.32.30
                                   HP F90 v2.3
     HP-UX B.11.00                 HP C  HP92453-01 A.11.01.20 
@@ -183,15 +230,20 @@ Platforms Tested
                                   HP F90 v2.4
                                   HP MPI [not a product] (03/24/2000) B6060BA
     IRIX 6.5                      MIPSpro cc 7.30
-    IRIX64 6.5 (64 & n32)         MIPSpro cc 7.3.1.2m
-    Linux 2.4.4                   gcc 2.95.3
+    IRIX64 6.5 (64 & n32)         MIPSpro cc 7.3.1.3m
+                                  F90 MIPSpro 7.3.1.3m (64 only)
+    Linux 2.4.9-31smp             gcc 2.95.3
                                   g++ 2.95.3
+                                  Intel(R) C++ Version 6.0
+                                  Intel(R) Fortran Compiler Version 6.0
+                                  MPICH 1.2.2
     Linux 2.2.18smp               gcc 2.95.2
                                   gcc 2.95.2 with mpich 1.2.1
                                   g++ 2.95.2
                                   pgf90 3.2-4
-    OSF1 V5.1                     Compaq C V6.3-028         
-                                  Compaq Fortran V5.4-1283
+    OSF1 V5.1                     Compaq C V6.4-014
+                                  Compaq Fortran V5.5-1877-48BBF
+                                  gcc version 3.0 for C++
     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 
                                   Workshop Compilers 5.0 98/10/25 
@@ -208,19 +260,19 @@ Platforms Tested
                                         109508-04 2001/07/11
     TFLOPS r1.0.4 v4.2.2 i386     pgcc Rel 3.1-4i with mpich-1.2.3 with
                                           local modifications
-    IA-32 Linux 2.2.10smpx        cc Intel 5.0.1
-                                  egcs-2.91.66
+    IA-32 Linux 2.4.9             cc Intel 5.0.1
+                                  gcc 2.96
+                                  Intel(R) C++ Version 6.0
+                                  Intel(R) Fortran Compiler Version 6.0
+                                  
     IA-64 Linux 2.4.16 ia64       gcc version 2.96 20000731
-                                  Intel(R) C++ Itanium(TM) Compiler 
-                                  for the Itanium(TM)-based applications,
-                                  Version 6.0 Beta, Build 20010905       
+                                  Intel(R) C++ Version 6.0
+                                  Intel(R) Fortran Compiler Version 6.0
     Windows 2000 (NT5.0)          MSVC++ 6.0
                                   DEC Visual Fortran 6.0
     Windows NT4.0                 MSVC++ 6.0
                                   DEC Visual Fortran 6.0
     Windows NT4.0                 Code Warrior 6.0
-    Windows 98                    MSVC++ 6.0
-                                  DEC Visual Fortran 6.0
 
 
 Supported Configuration Features Summary
@@ -239,7 +291,8 @@ Supported Configuration Features Summary
     Solaris2.7     y  y (1)     y    n         y     y          y     y
     Solaris2.8 64  y  n         y    n         y     y          y     y
     Solaris2.8 32  y  y (1)     y    n         y     y          y     y
-    IA-64          y  n         n    n         n     n          y     y 
+    IA-64          y  n         y    n         n     n          y     y 
+    IA-32	   y  n		y    n	       n     n          y     y 
     IRIX6.5        y  y (1)     n    n         n     y          y     y
     IRIX64_6.5 64  y  y (2)     y    y         n     y          y     y
     IRIX64_6.5 32  y  y (2)     n    n         n     y          y     y
@@ -267,6 +320,7 @@ Supported Configuration Features Summary
     Solaris2.8 64  n              y         n        n    n     y
     Solaris2.8 32  n              x         y        n    n     y
     IA-64          n              n         n        n    n     y   
+    IA-32	   n		  n	    n	     n    n     y
     IRIX6.5        n              x         y        n    n     y
     IRIX64_6.5 64  n              x         y        n    y     y
     IRIX64_6.5 32  n              x         y        n    y     y
@@ -280,7 +334,6 @@ Supported Configuration Features Summary
     AIX-4.3 SP2    n              y (3)     n        n    n     y
     AIX-4.3 SP3    n              y         n        n    n     y
     Win2000        n              y         n        n    n     n
-    Win98          n              y         n        n    n     n
     WinNT          n              y         n        n    n     n
     WinNT CW       n              n         n        n    n     n
     FreeBSD        n              y         y        n    n     y
@@ -329,15 +382,10 @@ Known Problems
       be off by default.  One may turn it on by setting environment variable
       HDF5_MPI_OPT_TYPES to a non-zero value such as 1.
 
-    * On IA64 systems one has to use -DIA64 compilation flag to compile
-      h4toh5 and h5toh4 utilites. After configuration step manually modify
-      Makefile in the tools/h4toh4 and tools/h5toh4 directories to add 
-      -DIA64 to the compilation flags.
-
-	* On IA32 and IA64 systems, if you use a compiler other than GCC (such as
-	  Intel's ecc or icc compilers), you will need to modify the generated
-	  "libtool" program after configuration is finished. On or around line 104
-	  of the libtool file, there are lines which look like:
+    * On IA32 and IA64 systems, if you use a compiler other than GCC (such as
+      Intel's ecc or icc compilers), you will need to modify the generated
+      "libtool" program after configuration is finished. On or around line 104
+      of the libtool file, there are lines which look like:
 
           # How to pass a linker flag through the compiler.
           wl=""
@@ -347,3 +395,17 @@ Known Problems
           # How to pass a linker flag through the compiler.
           wl="-Wl,"
 
+     * To build Fortran Library using Intel compilers one has to 
+          x modify source code in the fortran/src directory to remove !DEC and !MS
+            compiler's directives 
+          x build fails in fortran/test and then in frotran/examples directory;
+            to proceed edit work.pcl files in those directories to contain 
+            two lines
+
+                    work.pc
+                    ../src/work.pc 
+
+     * To build Fortran Library on IA64 use
+                   setenv CC "ecc -DIA64"
+                   setenv F9X "efc -cl,work.pcl"
+            before running configure and see steps described above.