[svn-r24337] Bring revisions #24200 - #24333 from trunk.

3 files changed, 69 insertions, 44 deletions

diff --git a/release_docs/INSTALL_CMake.txt b/release_docs/INSTALL_CMake.txt
index 80a13f7..5811bec 100644
--- a/release_docs/INSTALL_CMake.txt
+++ b/release_docs/INSTALL_CMake.txt
@@ -48,7 +48,7 @@ Notes: This short set of instructions is written for users who want to
          cpack -C Release CPackConfig.cmake
       
       6. Install with this command:
-         HDF5-1.8.11-win32.exe
+         HDF5-1.8.12-win32.exe
         
    B. Linux Quick Step Building HDF5 Libraries with CMake Using GCC
 
@@ -76,7 +76,7 @@ Notes: This short set of instructions is written for users who want to
          cpack -C Release CPackConfig.cmake
       
       6. Install with this command:
-         HDF5-1.8.11-Linux.sh
+         HDF5-1.8.12-Linux.sh
       
 
 
@@ -120,13 +120,20 @@ II. Preconditions
    4. Windows developers should install NSIS to create an install image with CPack.
       Visual Studio Express users will not be able to package HDF5 into
       an install image executable.
+   
+   5. Developers should copy the config/cmake/cacheinit.cmake file and alter the
+      the settings for the developers' environment. Then the only options needed
+      on the command line are those options that are different. Example using HDF
+      default cache file:
+               cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 10" \
+               -DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF -DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF ..
 
 
 Notes: 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 similar for
+       available for the configuration step. The steps are similar for
        all the operating systems supported by CMake.
        
        NOTES:
@@ -147,7 +154,8 @@ Notes: More information about using CMake can be found at the KitWare site,
                  www.hdfgroup.org/CDash/HowToSubmit. 
             
          4. See the appendix at the bottom of this file for examples of using
-            a ctest script for building and testing. 
+            a ctest script for building and testing. Using a ctest script is
+            preferred because of its flexibility.
             
 
 
@@ -170,7 +178,7 @@ These five steps are described in detail below.
 
    1. Run CMake
 
-      The CMake executable is named "cmake-gui.exe" on Windows and should be
+      The visual 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. 
@@ -183,7 +191,7 @@ These five steps are described in detail below.
       then use c:\MyHDFstuff\hdf5\build or c:\MyHDFstuff\build\hdf5 as the 
       build directory.
       
-      OPTIONAL:
+      PREFERRED:
         Users can perform the configuration step without using the visual 
         cmake-gui program. We use the file cacheinit.cmake in the 
         config/cmake folder for our testing. This file enables all the 
@@ -261,7 +269,7 @@ These five steps are described in detail below.
 
    2. Configure the cache settings
 
-      2.1  Click the Configure button. If this is the first time you are 
+      2.1  Visual CMake users, 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 
@@ -279,9 +287,9 @@ These five steps are described in detail below.
            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:
+      2.2  Preferred command line example on Windows in c:\MyHDFstuff\hdf5\build directory:
       
-               cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 9 2008" \
+               cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 10" \
                -DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF -DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF ..
 
       2.3  On Windows, if you are using a Visual Studio Express version you must 
@@ -293,7 +301,8 @@ These five steps are described in detail below.
    3. Build HDF5
    
       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.
+      or the command line. The command line can be used on all platforms;
+      Windows, linux, Unix, and Mac.
 
       To build from the command line, navigate to your build directory and
       execute the following:
@@ -478,8 +487,15 @@ The example is for a linux machine, but the same scripts can be used on
 a Windows machine by adjusting the CTEST_CMAKE_GENERATOR option in the
 product specific script.
 
-CTestScript.cmake
+NOTE: these files are available at the HDF web site:
+    http://www.hdfgroup.org/HDF5/release/cmakebuild.html
 
+    CTestScript.cmake
+    SZip.tar.gz
+    ZLib.tar.gz
+    
+    HDF518WindowsRWDICMake.cmake
+    HDF518LinuxRWDICMake.cmake
 
 
 ========================================================================
@@ -702,42 +718,42 @@ message("Dashboard script configuration:\n${vars}\n")
  
 #-----------------------------------------------------------------------------
 ## NORMAL process
-## -- LOCAL_SKIP_UPDATE skips updating the source folder from svn
-## -- LOCAL_NO_SUBMIT skips reporting to CDash server
+## -- LOCAL_UPDATE updates the source folder from svn
+## -- LOCAL_SUBMIT reports to CDash server
 ## -- LOCAL_SKIP_TEST skips the test process (only builds)
 ## -- LOCAL_MEMCHECK_TEST executes the Valgrind testing
 ## -- LOCAL_COVERAGE_TEST executes code coverage process
 ## --------------------------
 CTEST_START (${MODEL} TRACK ${MODEL})
-if(NOT LOCAL_SKIP_UPDATE)
+if(LOCAL_UPDATE)
   CTEST_UPDATE (SOURCE "${CTEST_SOURCE_DIRECTORY}")
-endif(NOT LOCAL_SKIP_UPDATE)
+endif(LOCAL_UPDATE)
 CTEST_CONFIGURE (BUILD "${CTEST_BINARY_DIRECTORY}")
 CTEST_READ_CUSTOM_FILES ("${CTEST_BINARY_DIRECTORY}")
-if(NOT LOCAL_NO_SUBMIT)
+if(LOCAL_SUBMIT)
   CTEST_SUBMIT (PARTS Update Configure Notes)
-endif(NOT LOCAL_NO_SUBMIT)
+endif(LOCAL_SUBMIT)
   CTEST_BUILD (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND)
-if(NOT LOCAL_NO_SUBMIT)
+if(LOCAL_SUBMIT)
   CTEST_SUBMIT (PARTS Build)
-endif(NOT LOCAL_NO_SUBMIT)
+endif(LOCAL_SUBMIT)
 if(NOT LOCAL_SKIP_TEST)
   if(NOT LOCAL_MEMCHECK_TEST)
     CTEST_TEST (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND ${ctest_test_args})
-    if(NOT LOCAL_NO_SUBMIT)
+    if(LOCAL_SUBMIT)
       CTEST_SUBMIT (PARTS Test)
-    endif(NOT LOCAL_NO_SUBMIT)
+    endif(LOCAL_SUBMIT)
   else(NOT LOCAL_MEMCHECK_TEST)
     CTEST_MEMCHECK (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND ${ctest_test_args})
-    if(NOT LOCAL_NO_SUBMIT)
+    if(LOCAL_SUBMIT)
       CTEST_SUBMIT (PARTS MemCheck)
-    endif(NOT LOCAL_NO_SUBMIT)
+    endif(LOCAL_SUBMIT)
   endif(NOT LOCAL_MEMCHECK_TEST)
   if(LOCAL_COVERAGE_TEST)
     CTEST_COVERAGE (BUILD "${CTEST_BINARY_DIRECTORY}" APPEND)
-    if(NOT LOCAL_NO_SUBMIT)
+    if(LOCAL_SUBMIT)
       CTEST_SUBMIT (PARTS Coverage)
-    endif(NOT LOCAL_NO_SUBMIT)
+    endif(LOCAL_SUBMIT)
   endif(LOCAL_COVERAGE_TEST)
 endif(NOT LOCAL_SKIP_TEST)
 if(NOT LOCAL_MEMCHECK_TEST)
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index 482a9da..fa6d9e0 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -1,4 +1,4 @@
-HDF5 version 1.9.165-swmr0 currently under development
+HDF5 version 1.9.167-swmr0 currently under development
 
 
 INTRODUCTION
@@ -1182,9 +1182,9 @@ Supported Platforms
                                   Visual Studio 2012 w/ Intel Fortran 13 (cmake)
                                   Cygwin(CYGWIN_NT-6.1 1.7.25(0.270/5/3) gcc(4.8.1) compiler and gfortran)
                                   (cmake and autotools)
-    Windows 8                     Visual Studio 2012 w/ Intel Fortran 13 (cmake)
+    Windows 8.1                   Visual Studio 2012 w/ Intel Fortran 13 (cmake)
 
-    Windows 8 x64                 Visual Studio 2012 w/ Intel Fortran 13 (cmake)
+    Windows 8.1 x64               Visual Studio 2012 w/ Intel Fortran 13 (cmake)
 
     Mac OS X Snow Leopard 10.6.8  gcc i686-apple-darwin11-llvm-gcc-4.2 (GCC) 4.2.1 from Xcode 3.2.6
     Darwin Kernel Version 10.8.0  g++ i686-apple-darwin11-llvm-g++-4.2 (GCC) 4.2.1 from Xcode 3.2.6
@@ -1291,32 +1291,32 @@ The following platforms are not supported but have been tested for this release.
                                   GNU Fortran (Debian 4.7.2-5) 4.7.2
                                   (cmake and autotools)
 
-    Fedora19 3.9.9-301.fc19.i6866 #1 SMP i686 i686 i386 GNU/Linux
+    Fedora19 3.11.1-200.fc19.i6866 #1 SMP i686 i686 i386 GNU/Linux
                                   gcc (GCC) 4.8.1 20130603 (Red Hat 4.8.1-1)
                                   GNU Fortran (GCC) 4.8.1 20130603 (Red Hat 4.8.1-1)
                                   (cmake and autotools)
 
-    Fedora19 3.9.9-301.fc19.x86_64 #1 SMP x86_64 x86_64 x86_64 GNU/Linux
+    Fedora19 3.11.1-200.fc19.x86_64 #1 SMP x86_64 x86_64 x86_64 GNU/Linux
                                   gcc (GCC) 4.8.1 20130603 (Red Hat 4.8.1-1)
                                   GNU Fortran (GCC) 4.8.1 20130603 (Red Hat 4.8.1-1)
                                   (cmake and autotools)
 
-    SUSE 12.3 3.7.10-1.1-desktop #1 SMP PREEMPT i686 i686 i386 GNU/Linux
+    SUSE 12.3 3.7.10-1.16-desktop #1 SMP PREEMPT i686 i686 i386 GNU/Linux
                                   gcc (SUSE Linux) 4.7.2
                                   GNU Fortran (SUSE Linux) 4.7.2
                                   (cmake and autotools)
 
-    SUSE 12.3 3.7.10-1.1-desktop #1 SMP PREEMPT x86_64 x86_64 x86_64 GNU/Linux
+    SUSE 12.3 3.7.10-1.16-desktop #1 SMP PREEMPT x86_64 x86_64 x86_64 GNU/Linux
                                   gcc (SUSE Linux) 4.7.2
                                   GNU Fortran (SUSE Linux) 4.7.2 
                                   (cmake and autotools)
 
-    Ubuntu 13.04 3.8.0-26-generic #38-Ubuntu SMP i686 GNU/Linux
+    Ubuntu 13.04 3.8.0-30-generic #44-Ubuntu SMP i686 GNU/Linux
                                   gcc (Ubuntu/Linaro 4.7.3-1ubuntu1) 4.7.3
                                   GNU Fortran (Ubuntu/Linaro 4.6.3-1ubuntu1) 4.7.3
                                   (cmake and autotools)
 
-    Ubuntu 13.04 3.8.0-26-generic #38-Ubuntu SMP x86_64 GNU/Linux
+    Ubuntu 13.04 3.8.0-30-generic #44-Ubuntu SMP x86_64 GNU/Linux
                                   gcc (Ubuntu/Linaro 4.7.3-1ubuntu1) 4.7.3
                                   GNU Fortran (Ubuntu/Linaro 4.7.3-1ubuntu1) 4.7.3
                                   (cmake and autotools)
@@ -1329,6 +1329,13 @@ The following platforms are not supported but have been tested for this release.
 
 Known Problems
 ==============
+* CLANG compiler with the options -fcatch-undefined-behavior and -ftrapv
+  catches some undefined behavior in the alignment algorithm of the macro DETECT_I
+  in H5detect.c (Issue 8147).  Since the algorithm is trying to detect the alignment 
+  of integers, ideally the flag -fcatch-undefined-behavior shouldn't to be used for 
+  H5detect.c. In the future, we can separate flags for H5detect.c from the rest of 
+  the library. (SLU - 2013/10/16)
+
 * The 5.9 C++ compiler on Sun failed to compile a C++ test ttypes.cpp.  It
   complains with this message:
       "/home/hdf5/src/H5Vprivate.h", line 130: Error: __func__ is not defined.
diff --git a/release_docs/USING_HDF5_CMake.txt b/release_docs/USING_HDF5_CMake.txt
index 3c04f36..313e0f0 100644
--- a/release_docs/USING_HDF5_CMake.txt
+++ b/release_docs/USING_HDF5_CMake.txt
@@ -77,7 +77,7 @@ These steps are described in more detail below.
 
    1. Run CMake
 
-      The CMake executable is named "cmake-gui.exe" on Windows and should be
+      The visual 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. 
@@ -87,7 +87,7 @@ These steps are described in more detail below.
       c:\MyHDFstuff\hdf5, then use c:\MyHDFstuff\hdf5\build or 
       c:\MyHDFstuff\build\hdf5 for the build directory. 
       
-      OPTIONAL:
+      PREFERRED:
         Users can perform the configuration step without using the visual 
         cmake-gui program. The following is an example command line 
         configuration step executed within the build directory:
@@ -118,9 +118,9 @@ These steps are described in more detail below.
 
    2. Configure the cache settings
 
-      2.1  Click the Configure button. If this is the first time you are 
+      2.1  Visual CMake users, 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). 
+           generator you wish to use (for example on Windows, Visual Studio 10). 
            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.
@@ -138,7 +138,7 @@ These steps are described in more detail below.
 
       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 ..
+           cmake -G "Visual Studio 10" -DBUILD_TESTING:BOOL=ON -DUSE_SHARED_LIBS:BOOL=ON ..
 
    3. Build HDF5 Applications
    
@@ -219,6 +219,13 @@ is entered on the command line and the build folder is created as a sub-folder.
 Windows should adjust the forward slash to double backslashes, except for
 the HDF_DIR environment variable.
 
+NOTE: these files are available at the HDF web site:
+    http://www.hdfgroup.org/HDF5/release/cmakebuild.html
+
+    CTestScript.cmake
+    
+    HDF518ExamplesWindowsbinaryCMake.cmake
+
 
 
 ========================================================================
@@ -253,11 +260,6 @@ set(SITE_OS_BITS "os size")
 set(SITE_COMPILER_NAME "compiler name")
 set(SITE_COMPILER_VERSION "compiler version")
 
-# skip submit to cdash
-set(LOCAL_NO_SUBMIT "True")
-# skip update source from repository
-set(LOCAL_SKIP_UPDATE "True")
-
 # needed for source updates, change as required
 set(REPOSITORY_URL "http://svn.hdfgroup.uiuc.edu/hdf5-examples/trunk/1_8")