[svn-r22105] Description:

	Bring r20557:22085 from trunk to this branch, also fixing some other
issues/failures in the branch simultaneously.  The h5repack tests are still
failing, but Neil will be checking into those, so the branch can be fully
functional again.

Tested on:
	Mac OSX/64 10.7.3 (amazon) w/debug

11 files changed, 593 insertions, 93 deletions

diff --git a/release_docs/CMake.txt b/release_docs/CMake.txt
index e916df9..2d15741 100755..100644
--- a/release_docs/CMake.txt
+++ b/release_docs/CMake.txt
@@ -25,8 +25,11 @@ Notes: This short instruction is written for users who want to quickly build
             Please send us any comments on how CMake support can be improved on 
             any system. Visit the KitWare site for more information about CMake.
             
-         3. Build and test results can be submitted to our CDash server at:
-            www.cdash.hdfgroup.org. 
+         3. If you are building HDF5 on Windows, do NOT use or execute any
+            files from the windows folder.
+            
+         4. Build and test results can be submitted to our CDash server at:
+            cdash.hdfgroup.uiuc.edu. 
             Please read the HDF and CDash document at:
             www.hdfgroup.org/CDash/HowToSubmit. 
             
@@ -36,7 +39,7 @@ Notes: This short instruction is written for users who want to quickly build
 ========================================================================                          
 
    1. We suggest you obtain the latest CMake for windows from the Kitware
-      web site. The HDF5 1.8.x product requires CMake version 2.8.4.                     
+      web site. The HDF5 1.8.x product requires CMake version 2.8.6.                     
                                                                          
    2. If you plan to use Zlib or Szip;
       A. Download the packages and install them
@@ -102,8 +105,8 @@ Notes: This short instruction is written for users who want to quickly build
         <options> is:
             * SZIP_INCLUDE_DIR:PATH=<path to szip includes directory>
             * SZIP_LIBRARY:FILEPATH=<path to szip/library file>
-            * ZLIB_INCLUDE_DIR:PATH=<path to szip includes directory>
-            * ZLIB_LIBRARY:FILEPATH=<path to szip/library file>
+            * ZLIB_INCLUDE_DIR:PATH=<path to zlib includes directory>
+            * ZLIB_LIBRARY:FILEPATH=<path to zlib/library file>
             * <HDF5OPTION>:BOOL=[ON | OFF]
 
         <cacheinit.cmake> is:
@@ -124,7 +127,6 @@ Notes: This short instruction is written for users who want to quickly build
             SET (HDF5_ENABLE_SZIP_ENCODING ON CACHE BOOL "Use SZip Encoding" FORCE)
             SET (HDF5_ENABLE_SZIP_SUPPORT ON CACHE BOOL "Use SZip Filter" FORCE)
             SET (HDF5_ENABLE_Z_LIB_SUPPORT ON CACHE BOOL "Enable Zlib Filters" FORCE)
-            SET (HDF5_USE_H5DUMP_PACKED_BITS ON CACHE BOOL "Use the PACKED BITS feature in h5dump" FORCE)
             SET (HDF5_ENABLE_COVERAGE OFF CACHE BOOL "Enable code coverage for Libraries and Programs" FORCE)
 
    2. Configure the cache settings
@@ -152,6 +154,12 @@ Notes: This short instruction is written for users who want to quickly build
                cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 9 2008" \
                -DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF -DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF ..
 
+      2.3  On Windows, if you are using a VS Express version you must be sure that the 
+           following two options are correctly set/unset:
+           
+           HDF5_NO_PACKAGES:BOOL=ON
+           HDF5_USE_FOLDERS:BOOL=OFF
+           
    3. Build HDF5
    
       On Windows, you can build HDF5 using either the Visual Studio Environment 
@@ -215,6 +223,10 @@ Notes: This short instruction is written for users who want to quickly build
       
       NOTE: We have just introduced the packaging capability and it has not been 
             extensively tested. Please send us comments on how it can be improved.
+            See NSIS note 8 of this document.
+            Also, if you are using a VS Express version or do not want to enable
+            the packaging components, set HDF5_NO_PACKAGES to ON (on the command
+            line add -DHDF5_NO_PACKAGES:BOOL=ON)
            
    6. The files that support building HDF5 with CMake are all the files in the 
       config/cmake folder, the CMakeLists.txt files in each source folder, and 
@@ -224,6 +236,63 @@ Notes: This short instruction is written for users who want to quickly build
 
    7. More information about using CMake can be found at the KitWare site, 
       www.cmake.org.
+      
+   8. Nullsoft Scriptable Install System
+      The Nullsoft Scriptable Install System (NSIS) is an open source installation 
+      system. It was created by the WinAmp authors to distribute that application, 
+      but it is now a general-purpose system which anyone might use. NSIS installers 
+      recognize /S for silent installation and /D=dir to specify the 
+      "output directory", which is where the program will be installed. These 
+      options are case-sensitive, so be sure to type them in upper case. 
+
+                                                                         
+========================================================================
+          All options for HDF5 C/C++ Libraries with CMake
+========================================================================
+OPTION (HDF5_Enable_Clear_File_Buffers "Securely clear file buffers before writing to file" ON)
+OPTION (HDF5_Enable_Instrument "Instrument The library" HDF5_Enable_Instrument)
+OPTION (HDF5_STRICT_FORMAT_CHECKS "Whether to perform strict file format checks" OFF)
+OPTION (HDF5_METADATA_TRACE_FILE "Enable metadata trace file collection" OFF)
+OPTION (HDF5_WANT_DATA_ACCURACY "IF data accuracy is guaranteed during data conversions" ON)
+OPTION (HDF5_WANT_DCONV_EXCEPTION "exception handling functions is checked during data conversions" ON)
+OPTION (HDF5_ENABLE_CODESTACK "Enable the function stack tracing (for developer debugging)." OFF)
+OPTION (HDF5_ENABLE_HSIZET "Enable datasets larger than memory" ON)
+OPTION (HDF5_ENABLE_LARGE_FILE "Enable support for large (64-bit) files on Linux." ON)
+OPTION (HDF5_ENABLE_GPFS "Enable GPFS hints for the MPI/POSIX file driver" OFF)
+IF (APPLE) OPTION (HDF5_BUILD_WITH_INSTALL_NAME "Build with library install_name set to the installation path" OFF)
+OPTION (BUILD_SHARED_LIBS "Build Shared Libraries" OFF)
+OPTION (BUILD_STATIC_EXECS "Build Static Executabless" OFF)
+OPTION (BUILD_STATIC_PIC "Build Static PIC" OFF)
+OPTION (HDF5_ENABLE_COVERAGE "Enable code coverage for Libraries and Programs" OFF)
+OPTION (HDF5_ENABLE_USING_MEMCHECKER "Indicate that a memory checker is used" OFF)
+OPTION (HDF5_ENABLE_DEPRECATED_SYMBOLS "Enable deprecated public API symbols" ON)
+OPTION (HDF5_ENABLE_TRACE "Enable API tracing capability" ON)
+OPTION (HDF5_ENABLE_TRACE "Enable API tracing capability" OFF)
+OPTION (HDF5_ENABLE_EMBEDDED_LIBINFO "embed library info into executables" ON)
+OPTION (HDF5_DISABLE_COMPILER_WARNINGS "Disable compiler warnings" OFF)
+OPTION (HDF5_ENABLE_PARALLEL "Enable parallel build (requires MPI)" OFF)
+OPTION (HDF5_USE_16_API_DEFAULT "Use the HDF5 1.6.x API by default" OFF)
+OPTION (HDF5_USE_18_API_DEFAULT "Use the HDF5 1.8.x API by default" OFF)
+OPTION (HDF5_USE_FILTER_${FILTER} "Use the ${FILTER} Filter" ON)
+OPTION (HDF5_ALLOW_EXTERNAL_SUPPORT "Allow External Library Building" "NO")
+OPTION (ZLIB_USE_EXTERNAL "Use External Library Building for ZLIB" 0)
+OPTION (SZIP_USE_EXTERNAL "Use External Library Building for SZIP" 0)
+OPTION (HDF5_ENABLE_Z_LIB_SUPPORT "Enable Zlib Filters" OFF)
+OPTION (HDF5_ENABLE_SZIP_SUPPORT "Use SZip Filter" OFF)
+IF (HDF5_ENABLE_SZIP_SUPPORT) OPTION (HDF5_ENABLE_SZIP_ENCODING "Use SZip Encoding" OFF)
+OPTION (HDF5_PACKAGE_EXTLIBS "CPACK - include external libraries" OFF)
+IF (WIN32 AND NOT CYGWIN) OPTION (HDF5_ENABLE_THREADSAFE "Enable Threadsafety" OFF)
+OPTION (BUILD_TESTING "Build HDF5 Unit Testing" OFF)
+OPTION (HDF5_TEST_VFD "Execute tests with different VFDs" OFF)
+IF (HDF5_TEST_VFD) OPTION (HDF5_TEST_FHEAP_VFD "Execute tests with different VFDs" ON)
+OPTION (HDF5_BUILD_FORTRAN "Build FORTRAN support" OFF)
+IF (HDF5_BUILD_FORTRAN) OPTION (HDF5_ENABLE_F2003 "Enable FORTRAN 2003 Standard" OFF)
+OPTION (HDF5_BUILD_EXAMPLES  "Build HDF5 Library Examples" OFF)
+OPTION (HDF5_BUILD_CPP_LIB  "Build HDF5 C++ Library" OFF)
+OPTION (HDF5_BUILD_TOOLS  "Build HDF5 Tools" OFF)
+OPTION (HDF5_BUILD_HL_LIB  "Build HIGH Level HDF5 Library" OFF)
+OPTION (HDF5_NO_PACKAGES "Do not include CPack Packaging" OFF)
+OPTION (HDF5_USE_FOLDERS "Do not include CPack Packaging" OFF)
 
 
 ************************************************************************
diff --git a/release_docs/COPYING b/release_docs/COPYING
index 6903daf..6903daf 100755..100644
--- a/release_docs/COPYING
+++ b/release_docs/COPYING
diff --git a/release_docs/INSTALL_Cygwin.txt b/release_docs/INSTALL_Cygwin.txt
index 8416dfc..5406820 100644
--- a/release_docs/INSTALL_Cygwin.txt
+++ b/release_docs/INSTALL_Cygwin.txt
@@ -181,7 +181,7 @@ Install HDF5 on Cygwin
        example, if users want to configure HDF5 C/C++/Fortran 
        library with szip library enabled, with zlib library at 
        /cygdrive/c/usr/, and install HDF5 into directory 
-       /cygdrive/c/hdf5 using gcc/g++ as C/C++ compiler and g95
+       /cygdrive/c/hdf5 using gcc/g++ as C/C++ compiler and gfortran
        as fortran compiler
      
            $ ./configure
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt
index 243ccba..e7184d4 100644
--- a/release_docs/INSTALL_Windows.txt
+++ b/release_docs/INSTALL_Windows.txt
@@ -68,6 +68,9 @@ Preconditions:
       Note: We have attempted to mirror our Autoconf configuration files for
             maintainence reasons. We are still working to synchronize the
             configuration files.
+            Also, if you are using a VS Express version or do not want to enable
+            the packaging components, set HDF5_NO_PACKAGES to ON (on the command
+            line add -DHDF5_NO_PACKAGES:BOOL=ON)
             
    5. Set up a directory structure to unpack the library.  For example:
 
diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt
index 7557441..7557441 100755..100644
--- a/release_docs/INSTALL_Windows_From_Command_Line.txt
+++ b/release_docs/INSTALL_Windows_From_Command_Line.txt
diff --git a/release_docs/INSTALL_Windows_Short_NET.TXT b/release_docs/INSTALL_Windows_Short_NET.TXT
index db144d1..db144d1 100755..100644
--- a/release_docs/INSTALL_Windows_Short_NET.TXT
+++ b/release_docs/INSTALL_Windows_Short_NET.TXT
diff --git a/release_docs/INSTALL_Windows_Short_VS2005.TXT b/release_docs/INSTALL_Windows_Short_VS2005.TXT
index 9ed15b4..9ed15b4 100755..100644
--- a/release_docs/INSTALL_Windows_Short_VS2005.TXT
+++ b/release_docs/INSTALL_Windows_Short_VS2005.TXT
diff --git a/release_docs/INSTALL_Windows_Short_VS2008.TXT b/release_docs/INSTALL_Windows_Short_VS2008.TXT
index 8ff8866..8ff8866 100755..100644
--- a/release_docs/INSTALL_Windows_Short_VS2008.TXT
+++ b/release_docs/INSTALL_Windows_Short_VS2008.TXT
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index 646b33e..00df5c6 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -1,4 +1,4 @@
-HDF5 version 1.9.81-FA_a5 currently under development
+HDF5 version 1.9.111-FA_a5 currently under development
 ================================================================================
 
 
@@ -39,6 +39,8 @@ New Features
 
     Configuration:
     -------------
+    - Added code to display the version information of XL fortran and C++
+      in the summary of configure. (AKC - 2012/02/28 - HDFFV-7793)
     - Configure now generates Makefiles that build in "silent make mode"
       by default in which compile and link lines are significantly
       simplified for clarity. To override this and view actual compile and
@@ -91,6 +93,12 @@ New Features
 
     Library:
     --------
+    - I added a new parameter of object access property list to the function 
+      H5Rdereference (Issue 2763).  It's called H5Rdereference2 now.  The former
+      H5Rdereference function has been deprecated to H5Rdereference1. (SLU -
+      2011/7/18)
+    - H5Tcreate now supports string type (fixed-length and variable-length).
+      (SLU - 2011/05/20)
     - Added ability to cache files opened through external links.  Added new
       public functions H5Pset_elink_file_cache_size(),
       H5Pget_elink_file_cache_size(), and H5Fclear_elink_file_cache().
@@ -150,6 +158,12 @@ New Features
 
     Parallel Library:
     -----------------
+    - Special Collective IO (IO when some processes do not contribute to the
+      IO) and Complex Derived Datatype MPI functionalities are no longer
+      conditionally enabled in the library by configure. They are always
+      enabled in order to take advantage of performance boosts from these
+      behaviors. Older MPI implementations that do not allow for these
+      functionalities can no longer by used by HDF5. (MAM - 2011/07/08).
     - Modified parallel tests to run with arbitrary number of processes. The
       modified tests are testphdf5 (parallel dataset access), t_chunk_alloc 
       (chunk allocation), and t_posix_compliant (posix compliance). The rest of
@@ -158,6 +172,38 @@ New Features
 
     Fortran Library:
     ----------------
+    HDF5 Fortran library was enhanced to support Fortran 2003 standard.
+    The following features are available when the HDF5 library is configured
+    using --enable-fortran --enable-fortran2003 configure flags AND
+    if fortran compiler is Fortran2003 compliant:
+
+     - Subroutines overloaded with the C_PTR derived type:
+         h5pget_f
+         h5pget_fill_value_f
+         h5pinsert_f
+         h5pregister_f
+         h5pset_f
+         h5pset_fill_value_f
+         h5rcreate_f
+         h5rderefrence_f
+         h5rget_name_f
+         h5rget_obj_type_f
+     - Subroutines overloaded with the C_PTR derived type
+       and simplified signatures:
+         h5aread_f
+         h5awrite_f
+         h5dread_f
+         h5dwrite_f
+     - New subroutines
+         h5dvlen_reclaim_f
+         h5literate_by_name_f
+         h5literate_f
+         h5ovisit_f
+         h5tconvert_f
+
+     - Subroutines with additional optional parameters:
+         h5pcreate_class_f
+                                               (EIP - 2011/10/14)
 
         - Added for the C APIs the Fortran wrappers:
             h5dget_access_plist_f
@@ -169,11 +215,11 @@ New Features
 
     C++ Library:
     ------------
-	- New member functions
-	  + Overloaded CommonFG::getObjnameByIdx to take char* for name
-	  + Overloaded CommonFG::getObjTypeByIdx to return type name as a char*.
+  - New member functions
+    + Overloaded CommonFG::getObjnameByIdx to take char* for name
+    + Overloaded CommonFG::getObjTypeByIdx to return type name as a char*.
             (BMR - 2010/05/02)
-	  + DataSet::getInMemDataSize() to simplify getting the dataset's
+    + DataSet::getInMemDataSize() to simplify getting the dataset's
             data size in memory.  (BMR - 2009/07/26)
         - These member functions were added as wrapper for H5Rdereference to
           replace the incorrect IdComponent::dereference().
@@ -195,6 +241,33 @@ New Features
 
     Tools:
     ------
+     - h5dump: Added capability for "-a" option to show attributes containing "/" 
+               by using an escape character. For example, for a dataset "/dset" 
+               containing attribute "speed(m/h)", use "h5dump -a "/dset/speed(\/h)" 
+               to show the content of the attribute. See details at HDFFV-7523
+               (PC -- 2012/03/12) 
+     - h5dump: Added ability to apply command options across multiple files using a
+               wildcard in the filename. Example; "h5dump -H -d Dataset1 tarr*.h5".
+               HDFFV-7876 (ADB - 2012/03/12).
+     - h5repack: Improved performance for big chunked datasets (size > 128MB)
+               when used with layout (-l) or compression (-f) option. 
+               It would perform much better prior to the improvement, 
+               especially for cases that chunk dimentions looks like 
+               "1024x5x1" (compare to "1x5x1024"). When bigger numbers
+               are toward front and smaller number is toward back in chunk
+               dimentions.  HDFFV-7862 (JKM - 2012/03/01)
+     - h5dump: Added new option --no-compact-subset. This option will not
+               interpret the '[' character as starting the compact form of 
+               subsetting. This is useful when the "h5dump error: unable to 
+               open dataset "datset_name"" message is output because a dataset
+               name contains a '[' character.  HDFFV-7689 (ADB - 2012/01/31)
+     - h5dump: Corrected schema location: 
+               <hdf5:HDF5-File 
+               xmlns:hdf5="http://hdfgroup.org/HDF5/XML/schema/HDF5-File" 
+               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+               xsi:schemaLocation="http://hdfgroup.org/HDF5/XML/schema/HDF5-File 
+               http://www.hdfgroup.org/HDF5/XML/schema/HDF5-File.xsd">
+               (ADB - 2011/08/10)
      - h5diff: Added new level for -v (verbose) option. The new levels are
                1 and 2.  So -v1 and -v2 can be specified to view more 
                information about attributes differences. 
@@ -216,7 +289,7 @@ New Features
      - h5diff: Add new flag --follow-symlinks. (refer to --help for details)
                (JKM - 2010/01/25) 
      - h5diff: fix for displaying garbage value on LE machine for BE data.
-	           (JKM - 2009/11/20)
+             (JKM - 2009/11/20)
      - h5dump: subsetting now allows default for count. Also trailing ; in short form
                can be omitted after last specified value. 
                (ADB - 2009/09/04)
@@ -265,6 +338,21 @@ New Features
      - Table: In version 3.0 of Table, "NROWS" (used to store number of records) was 
            deprecated (PVN - 2008/11/24)
 
+      - Added Fortran wrappers for Dimension Scale APIs. HDFFV-3797
+          h5dsset_scale_f
+          h5dsattach_scale_f
+          h5dsdetach_scale_f
+          h5dsis_attached_f
+          h5dsis_scale_f
+          h5dsset_label_f
+          h5dsget_label_f
+          h5dsget_scale_name_f
+          h5dsget_num_scales_f
+                  (EIP for SB - 2011/10/13)
+
+     - New API: h5ltpath_valid (Fortran: h5ltpath_valid_f) which checks
+       if a path is correct and determines if a link resolves to a valid
+       object and does not dangle. (MSB- 2012/3/15)
     
     Documentation 
     ------------- 
@@ -280,6 +368,48 @@ Bug Fixes since HDF5-1.8.0 release
 
     Library
     -------
+      - H5Pset_data_transform had seg fault in some cases like x*-100.  It
+            works correctly now and handles other cases like 100-x or 2/x.
+            (SLU - 2012/3/15.  Issue 7922) 
+      - Fixed rare corruption bugs that could occur when using the new object
+            header format. (NAF - 2012/3/15 - HDFFV-7879)
+      - Creating a dataset in a read-only file caused seg fault when the file 
+            is closed.  It's fixed.  The attemp to create a dataset will fail
+            with the error stack indicating the file is read-only. (SLU - 
+            2012/1/25. Issue 7756)
+      - Fixed a seg fault that could occur when shrinking a dataset with chunks
+            larger than 1 MB. (NAF - 2011/11/30 - HDFFV-7833)
+      - The library allowed the conversion of strings between ASCII and UTF8
+            (Issue 7582).  We have corrected it to report an error under this
+            situation. (SLU - 2011/11/8)
+      - The library had seg fault when it tried to shrink the size of compound type
+            through H5Tset_size immediately after the type was created (Issue
+            7618). It's fixed now. (SLU - 2011/10/26)
+      - Fixed a bug that occurred when using H5Ocopy on a committed datatype
+            containing an attribute using that committed datatype.
+            (NAF - 2011/10/13 - Issue 5854)
+      - #ifdef _WIN32 instances changed to #ifdef H5_HAVE_WIN32_API and added
+            H5_HAVE_VISUAL_STUDIO checks where necessary. CMake only as configure
+            never set _WIN32.
+      - CLANG compiler with the options -fcatch-undefined-behavior and -ftrapv
+            discovered 3 problems in tests and tools' library (Issue 7674):
+              1. In dsets.c, left shifting an unsigned int for 32 bits or more
+                 caused undefined behavior.
+              2. In dt_arith.c, the INIT_INTEGER macro definition has an overflow
+                 when the value is negative minimal and is being subtracted one.
+              3. In tools/lib/h5tools_str.c, right shifting an int value for 32 bits
+                 or more caused undefined behavior.
+            All the problems have been corrected. (SLU - 2011/9/2)
+      - In v1.6 library, there was EOA for the whole MULTI file saved in the 
+            super block.  We took it out in v1.8 library because it's meaningless 
+            for the MULTI file.  v1.8 library saves the EOA for the metadata file, 
+            instead. But this caused some backward compatibility problem.
+            v1.8 library couldn't open the file created with v1.6 library.  We
+            fixed the problem by checking the EOA value to detect the file
+            created with v1.6 library. (SLU - 2011/6/22) 
+      - When a dataset had filters and reading data failed, the error message 
+            didn't say which filter isn't registered. It's fixed now.
+            (SLU - 2011/6/3)  
       - The datatype handler created with H5Tencode/decode used to have the 
             reference count 0 (zero).  I have fixed it.  It is 1 (one) now.
             (SLU - 2011/2/18)
@@ -444,9 +574,9 @@ Bug Fixes since HDF5-1.8.0 release
         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)
+      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
@@ -463,6 +593,14 @@ Bug Fixes since HDF5-1.8.0 release
 
     Configuration
     -------------
+    - Added --enable-fortran2003 flag to enable Fortran2003 support
+      in the HDF5 Fortran library. The flag should be used along with the
+      --enable-fortran flag and takes affect only when Fortran compiler
+      is Fortran2003 compliant.         (EIP - 2011/11/14)
+
+    - In Windows platform, the default VFD, was Windows VFD, is restored back
+      to the SEC2, aka POSIX, VFD.  The Windows VFD is deprecated. HDFFV-7740
+      (AKC 2011/09/26)
     - Removed config/ibm-aix6.x. All IBM-AIX settings are in one file,
       ibm-aix. (AKC - 2011/4/14)
     - Shared C libraries are no longer disabled on Mac when Fortran
@@ -510,7 +648,7 @@ Bug Fixes since HDF5-1.8.0 release
       prior to configuration. MAM - 2009/03/09 - BZ #1401.
     - 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
+    - Wpen 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
@@ -520,13 +658,88 @@ Bug Fixes since HDF5-1.8.0 release
 
     Performance
     -------------
+      - ifdefs added to tests around include unistd.h and function to simulate
+        getlogin() on Windows. 
+        (ADB - 2011/08/15)
       - perf_serial test added to Windows projects and check batch file. 
         (ADB - 2009/06/11)
 
     Tools
     -----
+        - h5dump: Added tools library error stack to properly catch error
+          information generated within the library.
+          HDFFV-7958 (ADB 2012/03/12)
+        - h5dump: Dangling links no longer throw error message, change process
+          when open link fails.
+          HDFFV-7839 (ADB 2012/03/12)
+        - h5diff: When two symbolic dangling links are compared with 
+          --follow-symlinks option, the result should be same. It worked for 
+          comparing two files, but didn't work for comparing two objects.
+          HDFFV-7835 (JKM 2012/03/09)
+        - h5dump: Refactored code to remove duplicated functions. Split XML 
+          functions from DDL functions. Corrected indentation and formatting
+          errors. Also fixed subsetting counting overflow (HDFFV-5874). Verified
+          all tools call tools_init() in main.
+          HDFFV-7560 (ADB 2012/02/17)
+        - h5diff: fixed to prevent from displaying error stack message when 
+          comparing the two dangling symlinks with follow-symlinks option.
+          HDFFV-7836 (JKM 2012/01/13)
+        - h5repack: fixed memory leak for handling variable length string in 
+          attribute.  HDFFV-7840 (JKM 2012/01/06)
+        - h5ls: fixed segfault when access region reference data in an
+          attribute. HDFFV-7838 (JKM 2011/12/29)
+        - h5diff: fixed segfault over non-comparable attribute with different 
+          dimention or rank, along with '-c' option to display details.
+          HDFFV-7770 (JKM 2011/10/24)
+        - Fixed h5diff to display all the comparable object and attribute 
+          regardless of non-comparables. HDFFV-7693 (JKM 2011/09/16)
+        - Fixed h5repack to update values of references(object and region) of 
+          attributes in h5repack for 1) references, 2) ARRAY of references, 
+          3) VLEN of references, and 4) COMPOUND of references. 
+          (JIRA HDF5 5932) PC -2011/09/14
+        - h5diff: fixed segfault over dataset with container types
+          (array,lven) with multiple nested compound types. 
+          (ex: compound->array->compound, compound->vlen->compound)
+          HDFFV-7712  JKM (2011/09/01)
+        - h5repack: added macro to handle failure in H5Dread/write when memory 
+          allocation failed inside the library. (PC -- 2011/08/19)
+        - Fixed h5jam not to allow specifying an HDF5 formatted file as input 
+          file for -u (user block file) option, because the original HDF5 file 
+          will not be accessible if allows. HDFFV-5941 (JKM 2011/08/15)
+        - Revised command help pages of h5jam and h5unjam. The descriptions
+          were not up to date and some were missing. 
+          HDFFV-7515 (JKM 2011/08/15)
+        - h5repack: h5repack failed to copy dataset if the layout is changed 
+          from chunked with unlimited dims to contiguous. HDFFV-7649 
+          (PC -- 2011/07/15)
+        - h5diff: "--delta" option considers two NaN of the same type are 
+          different, which is wrong based on h5diff description in Reference
+          Manual. HDFFV-7656  (PC -- 2011/07/15)
+        - Fixed h5diff to display instructive error message and exit with 1
+          when mutually exclusive options (-d, -p and --use-system-epsilon)
+          are used together. HDFFV-7600  (JKM 2011/07/07)
+        - Fixed h5dump to display the first line of each element into correct 
+          position for multiple dimention array type.
+          Before this fix, the first line of each element in array were 
+          displayed after the last line of previous element without
+          moving to the next line (+indentation). 
+          Bug #HDFFV-5878  (JKM 2011/06/15)
+        - Fixed h5dump to display correct value for H5T_STD_I8LE dataset
+          on a system (ppc64, linux, Big-Endian, clustering). 
+          Bug #HDFFV-7594  (ABERT & JKM 2011/05/12)
+        - Fixed h5diff to compare file itself correctly. Previously h5diff
+          reported either different or not compatible in certain cases even
+          comparing file itself. This fix also improve performance when
+          comparing same target objects through verifying the obj&file
+          addresses before comparing the details in the objects (ex: datasets
+          or attributes) Bug #HDFFV-5928  (XCAO & JKM 2011/05/06)
         - Updated h5dump test case script to prevent entire test failure upon 
           source directory is read-only. Bug# HDFFV-4342 (JKM 2011/4/12)
+        - Fixed h5dump displaying incorrect values for H5T_STD_I8BE type data in
+          attribute on Big-Endian machine. H5T_STD_I8BE is unsigned 8bit type,
+          so h5dump is supposed to display -2 instead of 254. It worked 
+          correctly on Little-Endian system , but not on Big-Endian system.  
+          Bug #HDFFV-4358 (JKM 2011/04/08)
         - Updated to unify option name to '--enable-error-stack' for printing 
           HDF5 error stack messages for HDF5 tools. h5ls and h5dump for now.
           For h5ls, this replaces "-e/--errors" option, which is deprecated. 
@@ -613,7 +826,7 @@ Bug Fixes since HDF5-1.8.0 release
             (NAF - 2008/10/15)
         - Fixed unnecessary indentation of committed datatypes in h5dump.
             (NAF - 2008/10/15)
-	- Fixed bugs in h5stat:segmemtation fault when printing groups and
+        - Fixed bugs in h5stat:segmemtation fault when printing groups and
           print warning message when traversal of objects is unsuccessful.
           (see bug #1253) (VC- 2008/10/13)
         - Fixed bug in h5ls that prevented relative group listings (like
@@ -633,8 +846,12 @@ Bug Fixes since HDF5-1.8.0 release
            was done incorrectly. Removed printing of attributes when doing binary 
            output. PVN - 2008/06/05
 
+
     High-Level APIs:
      ------
+      - Fixed the H5LTdtype_to_text function.  It had some memory problems when
+        dealing with some complicated data types. HDFFVI-7701 (SLU - 2011/10/19)
+
       - Fixed a bug in H5DSattach_scale, H5DSis_attached and H5DSdetach_scale
         caused by using H5Tget_native_type function to determine the native
         type for reading REFERENCE_LIST attribute. The bug was exposed
@@ -665,27 +882,31 @@ Bug Fixes since HDF5-1.8.0 release
 
 
 
-
     Documentation 
     ------------- 
 
 
     F90 APIs
     --------
-
+       - Modified the h5open_f and h5close_f subroutines to not to call H5open
+         and H5close correspodningly. While the H5open call just adds overhead,
+         the H5close call called by an Fortran application shuts down the HDF5 
+         library making it unaccessible to the application. 
+                                              HDFFV-915 (EIP & SB - 2011/10/13)
+ 
 
     C++ APIs
     --------
-	- The constructor PropList::PropList(id) was fixed to act properly
-	  according to the nature of 'id'.  When 'id' is a property class id,
-	  a new property list will be created.  When 'id' id a property list id,
-	  a copy of the property list will be made. (BMR - 2010/5/9)
-	- The parameters 'size' and 'bufsize' in CommonFG::getLinkval and
-	  CommonFG::getComment, respectively, now have default values for
-	  user's convenience.  (BMR - 2009/10/23)
-	- NULL pointer accessing was fixed, bugzilla 1061.  (BMR - 2009/10/05)
-	- read/write methods of DataSet and Attribute classes were fixed
-	  to handle string correctly.  (BMR - 2009/07/26)
+  - The constructor PropList::PropList(id) was fixed to act properly
+    according to the nature of 'id'.  When 'id' is a property class id,
+    a new property list will be created.  When 'id' id a property list id,
+    a copy of the property list will be made. (BMR - 2010/5/9)
+  - The parameters 'size' and 'bufsize' in CommonFG::getLinkval and
+    CommonFG::getComment, respectively, now have default values for
+    user's convenience.  (BMR - 2009/10/23)
+  - NULL pointer accessing was fixed, bugzilla 1061.  (BMR - 2009/10/05)
+  - read/write methods of DataSet and Attribute classes were fixed
+    to handle string correctly.  (BMR - 2009/07/26)
         - 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)
@@ -706,53 +927,67 @@ Bug Fixes since HDF5-1.8.0 release
 Platforms Tested
 ================
 
-    AIX 6.1                       xlc 11.1.0.3
-    (NCSA BP)                     xlC 11.1.0.3
-                                  xlf 13.1.0.3
-                                  mpcc_r 11.1.0.3
-                                  mpxlf_r 13.1.0.3
-
-    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
-                                  g++ 4.2.1 20080123
-                                  gfortran 4.2.1 20080123
-
-    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 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, 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.10                    Sun C 5.9 SunOS_sparc 
-                                  Patch 124867-11 2009/04/30
-    (linew)                       Sun Fortran 95 8.3 SunOS_sparc 
-                                  Patch 127000-11 2009/10/06
-                                  Sun C++ 5.9 SunOS_sparc 
-                                  Patch 124863-16 2009/09/15
-    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.5..10-intel-r2
-    
+    AIX 5.3                       xlc 10.1.0.5
+    (NASA G-ADA)                  xlC 10.1.0.5
+                                  xlf90 12.1.0.6
+
+    FreeBSD 8.2-STABLE i386       gcc 4.2.1 [FreeBSD] 20070719
+    (loyalty)                     g++ 4.2.1 [FreeBSD] 20070719
+                                  gcc 4.6.1 20110422
+                                  g++ 4.6.1 20110422
+                                  gfortran 4.6.1 20110422
+
+    FreeBSD 8.2-STABLE amd64      gcc 4.2.1 [FreeBSD] 20070719
+    (freedom)                     g++ 4.2.1 [FreeBSD] 20070719
+                                  gcc 4.6.1 20110422
+                                  g++ 4.6.1 20110422
+                                  gfortran 4.6.1 20110422
+
+    Linux 2.6.18-194.3.1.el5PAE   gcc (GCC) 4.1.2 and 4.4.2
+    #1 SMP i686 i686 i386         GNU Fortran (GCC) 4.1.2 20080704
+    (jam)                             (Red Hat 4.1.2-48) and 4.4.2
+                                  PGI C, Fortran, C++ 10.4-0 32-bit
+                                  PGI C, Fortran, C++ 10.6-0 32-bit
+                                  Intel(R) C Compiler for 32-bit
+                                      applications, Version 11.1
+                                  Intel(R) C++ Compiler for 32-bit
+                                      applications, Version 11.1
+                                  Intel(R) Fortran Compiler for 32-bit
+                                      applications, Version 11.1
+                                  MPICH mpich2-1.3.1 compiled with
+                                      gcc 4.1.2 and gfortran 4.1.2
+
+    Linux 2.6.18-238.12.1.el5     gcc 4.1.2 and 4.4.2
+    #1 SMP x86_64 GNU/Linux       GNU Fortran (GCC) 4.1.2 20080704
+    (koala)                           (Red Hat 4.1.2-46) and 4.4.2
+                                      tested for both 32- and 64-bit binaries
+                                  Intel(R) C, C++, Fortran Compilers for
+                                      applications running on Intel(R) 64,
+                                      Version 11.1.
+                                  PGI C, Fortran, C++ Version 9.0-4
+                                      for 64-bit target on x86-64
+                                  MPICH mpich2-1.3.1 compiled with
+                                      gcc 4.1.2 and gfortran 4.1.2
+
+    SGI ProPack 7 Linux           Intel(R) C++ Version 11.1 20100806
+    2.6.32.19-0.3.1.1982.0.PTF-   Intel(R) Fortran Version 11.1 20100806
+    default #1 SMP                SGI MPT 2.01
+    SGI Altix UV
+    (NCSA ember)
+
+    SunOS 5.10 32- and 64-bit     Sun C 5.9 Sun OS_sparc Patch 124867-16
+    (linew)                       Sun Fortran 95 8.3 Sun OS_sparc Patch
+127000-13
+                                  Sun C++ 5.9 Sun OS_sparc Patch 124863-62
+                                  Sun C 5.10 SunOS_sparc Patch 141861-07
+                                  Sun Fortran 95 8.4 SunOS_sparc Patch
+128231-06
+                                  Sun C++ 5.10 SunOS_sparc 128228-11
+ 
     Windows XP                    Visual Studio 2008 w/ Intel Fortran 11.1
                                   Visual Studio 2010
                                   Cygwin(1.7.7 native gcc(4.3.4) compiler and gfortran)
-				  
+          
     Windows XP x64                Visual Studio 2008 w/ Intel Fortran 11.1
                                   Visual Studio 2010
                                   Cygwin(1.7.7 native gcc(4.3.4) compiler and gfortran)
@@ -786,14 +1021,12 @@ 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
-AIX 6.1 32- and 64-bit             n        y      n        y     y     y
 Windows XP                         n        y(3)   n(3)     y     y     y
 Windows XP x64                     n        y(3)   n(3)     y     y     y
 Windows Vista                      n        y(3)   n(3)     y     y     y
 Windows Vista x64                  n        y(3)   n(3)     y     y     y
 Mac OS X 10.5 Intel                n        y      n        y     y     y
-FreeBSD 6.2 32-bit                 n        n      n        y     y     y
-FreeBSD 6.2 64-bit
+FreeBSD 8.2 32- and 64-bit         n        x      n        x     y     y
 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
@@ -814,14 +1047,12 @@ Platform                          Shared   Shared    Shared    static-  Thread-
                                   C libs   F90 libs  C++ libs  exec     safe
 SunOS 5.10 32-bit                   y        y         y         x        y
 SunOS 5.10 64-bit                   y        y         y         x        y
-AIX 6.1 32- and 64-bit              n        n         n         x	  y
 Windows XP                          y        y(3)      y         y        n
 Windows XP x64                      y        y(3)      y         y        n
 Windows Vista                       y        y(3)      y         y        y
 Windows Vista x64                   y        y(3)      y         y        y
 Mac OS X 10.5 Intel                 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
+FreeBSD 8.2 32- and 64-bit          y        x         x         y        y
 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
@@ -847,6 +1078,18 @@ SuSe Linux 2.6.5
 
 Known Problems
 ==============
+* The data conversion test dt_arith.c fails in "long double" to integer
+  conversion on Ubuntu 11.10 (3.0.0.13 kernal) with GCC 4.6.1 if the library
+  is built with optimization -O3 or -O2.  The older GCC (4.5) or newer kernal
+  (3.2.2 on Fedora) doesn't have the problem.  Users should lower down the 
+  optimization level (-O1 or -O0) by defining CFLAGS in the command line of 
+  "configure" like:
+
+      CFLAGS=-O1 ./configure
+
+  It will overwrite the library's default optimization level. (Issue 7829. 
+  SLU - 2012/2/7)
+ 
 * --with-mpe configure option does not work with Mpich2. AKC - 2011/03/10)
 
 * While working on the 1.8.6 release of HDF5, a bug was discovered that can
@@ -865,13 +1108,6 @@ Known Problems
   it treats "exit(134) the same as if process 0 had received an abort signal.
   This is fixed and will be available in the next release. AKC - 2009/11/3
 
-* Some tests in tools/h5repack may fail in AIX systems when -q32 mode is used.
-  The error is due to insufficient memory requested. Request a large amount
-  of runtime memory by setting the following environment variable for more
-  memory.
-     LDR_CNTRL=MAXDATA=0x20000000@DSA
-  AKC - 2009/10/31
-
 * The PathScale MPI implementation, accessing a Panasas file system, would
   cause H5Fcreate() with H5F_ACC_EXCL to fail even when the file is not
   existing. This is due to the MPI_File_open() call failing if the amode has
@@ -1019,13 +1255,13 @@ 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 HDF make files and test scipts to execute your filter script
   by setting the environment variable "RUNSERIAL" to the full path of the 
diff --git a/release_docs/USING_Windows.txt b/release_docs/USING_Windows.txt
index 4e78c68..410a759 100644
--- a/release_docs/USING_Windows.txt
+++ b/release_docs/USING_Windows.txt
@@ -87,7 +87,7 @@ Preconditions:
       Variables" box.
 
       In the New Variable window, set "Variable name" as HDF5_EXT_ZLIB and 
-      "Variable value" as zlib1.lib, then click OK.
+      "Variable value" as zlib.lib, then click OK.
 
       Similarly, you can set:
 
@@ -98,7 +98,7 @@ Preconditions:
          a. You will have to close and reopen running programs for the new 
             environment variable settings to take effect.
 
-         b. c:\zlib\zlib1.dll and c:\szip\dll\szip.dll should be copied 
+         b. c:\zlib\zlib.dll and c:\szip\dll\szip.dll should be copied 
             into a location that the application can find.
 
    9. Set up path for libraries and headers
@@ -123,6 +123,16 @@ Preconditions:
           
       9.4 If building Fortran applications, you will also need to setup the path
           for the Intel Fortran compiler.  Please see Section VI.
+          
+      NOTE:
+          If you are using VS2010, the path settings will need to be in project
+          property sheets per project. Go to "Project" and select "Properties", find 
+          "Configuration Properties", and then "VC++ Directories".
+          
+          9.1 If you are building on 64-bit Windows, find the "Platform" dropdown
+              and select "x64".
+          9.2 Add the header path to the "Include Directories" setting.
+          9.3 Add the library path to the "Library Directories" setting.
 
 Notes:
 
@@ -595,7 +605,7 @@ Building with Visual Studio 2010 is very similar to building with Visual Studio
 with the following considerations:
 
     1. Visual Studio 2010 uses a new format for project files, but Visual Studio
-       2008 project files can be easily converted.  The HDF5 project files
+       2008 project files can be converted.  The HDF5 project files
        will need to be converted on first use.  To do so:
        
        1.1. Open the HDF5 Visual Studio 2008 solution file as in Section II
@@ -610,7 +620,8 @@ with the following considerations:
        1.3. When it is finished, it should state that all projects were
             converted successfully with no errors.  Warnings can be ignored.
             
-    2. Once the project files have been converted, build and test normally.
+    2. Once the project files have been converted you will need to create project 
+       property sheets for the library and include paths. Then build and test normally.
        Note that the converted project files aren't backwards compatible with
        previous versions of Visual Studio.
 
diff --git a/release_docs/Using_CMake.txt b/release_docs/Using_CMake.txt
new file mode 100644
index 0000000..4819815
--- /dev/null
+++ b/release_docs/Using_CMake.txt
@@ -0,0 +1,181 @@
+************************************************************************
+* Build and Install HDF5 Examples with CMake                           *
+************************************************************************
+
+Notes: This short instruction is written for users who want to quickly build 
+       HDF5 Examples from the HDF5 source code package using the CMake tools.
+       
+       More information about using CMake can be found at the KitWare site, 
+       www.cmake.org.
+         
+       CMake uses the command line, however the visual CMake tool is 
+       recommended for the configuration step. The steps are similiar for
+       all the operating systems supported by CMake.
+       
+       NOTES:
+         1. Using CMake for building and using HDF5 is under active development. 
+            While we have attempted to provide error-free files, please 
+            understand that development with CMake has not been extensively 
+            tested outside of HDF. The CMake specific files may change
+            before the next release.
+            
+         2. CMake was originally introduced to support development on Windows, 
+            however it should be usable on any system where CMake is supported. 
+            Please send us any comments on how CMake support can be improved on 
+            any system. Visit the KitWare site for more information about CMake.
+            
+         3. Build and test results can be submitted to our CDash server at:
+            cdash.hdfgroup.uiuc.edu. 
+            Please read the HDF and CDash document at:
+            www.hdfgroup.org/CDash/HowToSubmit. 
+            
+
+========================================================================
+                            Preconditions                                                           
+========================================================================                          
+
+   1. We suggest you obtain the latest CMake for windows from the Kitware
+      web site. The HDF5 1.8.x product requires CMake version 2.8.6.                     
+                                                                         
+   2. You have installed the HDF5 library built with CMake. If you are
+      using a Windows platform, you can obtain a pre-built Windows binary
+      from The HDF Group's website at www.hdfgroup.org.
+
+   3. On Windows with Visual Studio, if you have installed the static HDF5
+      library, you will need to add the HDF5\lib folder to the library
+      search list. See the "Using Static Libraries with Visual Studio" section.
+ 
+   4. Set the environment variable HDF5_ROOT to the installed location of HDF5.
+      On Windows HDF5_ROOT=C:\Program Files\HDF Group\HDF5\hdf5-1.8.7
+                                                                         
+========================================================================
+          Building HDF5 Examples with CMake
+========================================================================
+
+   1. Run CMake
+
+      The CMake executable is named "cmake-gui.exe" on Windows and should be
+      available in your Start menu. For Linux, UNIX, and Mac users the
+      executable is named "cmake-gui" and can be found where CMake was 
+      installed. 
+      Specify the source and build directories. It is recommemded that you 
+      choose a build directory different then the source directory 
+      (for example on Windows, if the source is at c:\MyHDFstuff\hdf5, then
+      use c:\MyHDFstuff\hdf5\build or c:\MyHDFstuff\build\hdf5). 
+      
+      OPTIONAL:
+        Users can perform the configuration step without using the visual cmake-gui
+        program. Example configuration step executed within the build directory:
+        
+        cmake -G "<generator>"  [-D<options>]  <sourcepath>
+        
+        Where <generator> is    
+            * Borland Makefiles
+            * MSYS Makefiles
+            * MinGW Makefiles
+            * NMake Makefiles
+            * Unix Makefiles
+            * Visual Studio 10
+            * Visual Studio 10 Win64
+            * Visual Studio 6
+            * Visual Studio 7
+            * Visual Studio 7 .NET 2003
+            * Visual Studio 8 2005
+            * Visual Studio 8 2005 Win64
+            * Visual Studio 9 2008
+            * Visual Studio 9 2008 Win64
+
+        <options> is:
+            * BUILD_TESTING:BOOL=ON
+            * USE_SHARED_LIBS:BOOL=[ON | OFF]
+
+   2. Configure the cache settings
+
+      2.1  Click the Configure button. If this is the first time you are 
+           running cmake-gui in this directory, you will be prompted for the 
+           generator you wish to use (for example on Windows, Visual Studio 9 2008). 
+           CMake will read in the CMakeLists.txt files from the source directory and 
+           display options for the HDF5 project. After the first configure you 
+           can adjust the cache settings and/or specify locations of other programs.
+      
+           Any conflicts or new values will be highlighted by the configure
+           process in red. Once you are happy with all the settings and there are no 
+           more values in red, click the Generate button to produce the appropriate 
+           build files. 
+      
+           On Windows, if you are using a Visual Studio generator, the solution and 
+           project files will be created in the build folder.
+      
+           On linux, if you are using the Unix Makefiles generator, the Makefiles will
+           be created in the build folder.
+
+      2.2  Alternative command line example on Windows in c:\MyHDFstuff\hdf5\build directory:
+      
+           cmake -G "Visual Studio 9 2008" -DBUILD_TESTING:BOOL=ON -DUSE_SHARED_LIBS:BOOL=ON ..
+
+   3. Build HDF5 examples
+   
+      On Windows, you can build HDF5 using either the Visual Studio Environment 
+      or the command line. The command line is used on linux, Unix, and Mac.
+
+      To build from the command line, navigate to your build directory and
+      execute the following;
+          
+              cmake --build . --config {Debug | Release}     
+              
+      NOTE: "--config {Debug | Release}" may be optional on your platform. We
+            recommend choosing either Debug or Release on Windows. If you are
+            using the pre-built binaries from HDF, use Release.                                                                                     
+             
+      3.1  If you wish to use the Visual Studio environment, open the solution 
+           file in your build directory. Be sure to select either Debug or 
+           Release and build the solution.
+             
+   4. Test HDF5 Examples.
+
+      To test the build, navigate to your build directory and execute;
+      
+              ctest . -C {Debug | Release}
+              
+      NOTE: "-C {Debug | Release}" may be optional on your platform. We
+            recommend choosing either Debug or Release to match the build
+            step on Windows.                                                                                      
+
+   6. The files that support building with CMake are all the files in the 
+      config/cmake folder, the CMakeLists.txt files in each source folder, and 
+      CTestConfig.cmake. CTestConfig.cmake is specific to the internal testing 
+      performed by The HDF Group. It should be altered for the users 
+      installation and needs.
+
+   7. More information about using CMake can be found at the KitWare site, 
+      www.cmake.org.
+                         
+                                                                         
+========================================================================
+          Using HDF5 Libraries with Visual Studio 2008
+========================================================================
+
+   8. Set up path for external libraries and headers
+
+      Invoke Microsoft Visual Studio and go to "Tools" and select "Options", 
+      find "Projects", and then "VC++ Directories".
+      
+      8.1 If you are building on 64-bit Windows, find the "Platform" dropdown
+          and select "x64".
+
+      8.2 Find the box "Show directories for", choose "Include files", add the 
+          header path (i.e. c:\Program Files\HDF Group\HDF5\hdf5-1.8.7\include)
+          to the included directories.
+
+      8.3 Find the box "Show directories for", choose "Library files", add the
+          library path (i.e. c:\Program Files\HDF Group\HDF5\hdf5-1.8.7\lib)
+          to the library directories.
+          
+      8.4 If using Fortran libraries, you will also need to setup the path
+          for the Intel Fortran compiler.
+
+
+************************************************************************
+
+Need further assistance, send email to help@hdfgroup.org
+