mirror/hdf5
2
0
Fork 0
mirror of https://github.com/HDFGroup/hdf5.git synced 2024-11-27 02:10:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

[svn-r25005] Update release docs

Browse Source
This commit is contained in:
Allen Byrne 2014-04-09 13:56:19 -05:00
parent c0bb145242
commit 3edb726818
4 changed files with 31 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
release_docs/INSTALL_CMake.txt
View File

@ -89,7 +89,7 @@ Notes: This short set of instructions is written for users who want to
c:\MyHDFstuff\hdf5\build
4. Configure the C library, tools and tests with this command:
cmake -G "Visual Studio 10" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..
cmake -G "Visual Studio 11" -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_TESTING:BOOL=ON -DHDF5_BUILD_TOOLS:BOOL=ON ..
The two dots on the end of the command is the location of the source.
The CMAKE_BUILD_TYPE must match the configuration type.
@ -103,7 +103,7 @@ Notes: This short set of instructions is written for users who want to
cpack -C Release CPackConfig.cmake
8. Install with this command:
HDF5-1.8.12-win32.exe
HDF5-1.8.13-win32.exe
B. Linux Quick Step Building HDF5 Libraries with CMake Using GCC
@ -133,7 +133,7 @@ Notes: This short set of instructions is written for users who want to
cpack -C Release CPackConfig.cmake
8. Install with this command:
HDF5-1.8.12-Linux.sh
HDF5-1.8.13-Linux.sh
@ -184,7 +184,7 @@ III. Preconditions
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" \
cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 11" \
-DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF -DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF \
-DCMAKE_BUILD_TYPE:STRING=Release ..
@ -262,22 +262,15 @@ These five steps are described in detail below.
cmake -C <sourcepath>/config/cmake/cacheinit.cmake -G "<generator>" [-D<options>] <sourcepath>
Where <generator> is
* Borland Makefiles
* MSYS Makefiles
* MinGW Makefiles
* NMake Makefiles
* Unix Makefiles
* Visual Studio 12
* Visual Studio 12 Win64
* Visual Studio 11
* Visual Studio 11 Win64
* 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:
* SZIP_INCLUDE_DIR:PATH=<path to szip includes directory>
@ -350,7 +343,7 @@ These five steps are described in detail below.
2.2 Preferred command line example on Windows in c:\MyHDFstuff\hdf5\build directory:
cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 10" \
cmake -C ../config/cmake/cacheinit.cmake -G "Visual Studio 11" \
-DHDF5_ENABLE_SZIP_SUPPORT:BOOL=OFF -DHDF5_ENABLE_Z_LIB_SUPPORT:BOOL=OFF \
-DCMAKE_BUILD_TYPE:STRING=Release ..
@ -452,7 +445,7 @@ These five steps are described in detail below.
========================================================================
V. All Options for HDF5 C/C++ Libraries with CMake
V. More Options for HDF5 C/C++ Libraries with CMake
========================================================================
In the options listed below, there are three columns of information:
@ -503,8 +496,6 @@ if (CMAKE_BUILD_TYPE MATCHES Debug)
HDF5_ENABLE_TRACE "Enable API tracing capability" ON
if (HDF5_TEST_VFD)
HDF5_TEST_FHEAP_VFD "Execute fheap test with different VFDs" ON
if (WIN32 AND NOT CYGWIN)
HDF_LEGACY_NAMING "Use Legacy Names for Libraries and Programs" OFF
---------------- External Library Options ---------------------
HDF5_ALLOW_EXTERNAL_SUPPORT "Allow External Library Building" "NO"
@ -897,7 +888,7 @@ set(LOCAL_NO_PACKAGE "TRUE")
#set(LOCAL_UPDATE "TRUE")
set(REPOSITORY_URL "http://svn.hdfgroup.uiuc.edu/hdf5/branches/hdf5_1_8")
#uncomment to use a compressed source file *.zip
#set(CTEST_USE_TAR_SOURCE "hdf5-1.8.12")
#set(CTEST_USE_TAR_SOURCE "hdf5-1.8.13")
############################################
#### Change default configuration of options in config/cmake/cacheinit.cmake file ###

21
release_docs/RELEASE.txt
View File

@ -41,6 +41,9 @@ New Features
Configuration:
-------------
- Autotools: Automake updated to 1.14.1 (ADB - 2014/04/08)
- CMake: Moved minimum CMake version to 2.8.11 which enables better library
include processing. (ADB - 2014/03/26)
- New configuration option added to change the default plugin path.
configure option is --with-default-plugin=location
cmake option is -DH5_DEFAULT_PLUGINDIR:PATH=location
@ -428,6 +431,11 @@ Bug Fixes since HDF5-1.8.0 release
Library
-------
- H5Z.c: H5Zfilter_avail(H5Z_filter_t id)
Added else block if the call to the internal H5Z_filter_avail(id) does not
fail and returns FALSE. This block calls the H5PL_load(H5PL_TYPE_FILTER, (int)id)
function to attempt to dynamically load the filter plugin.
(ADB - 2014/03/03 HDFFV-8629)
- Added const qualifier to source buffer parameters in H5Dgather and
H5D_scatter_func_t (H5Dscatter callback). (NAF - 2013/7/02)
- Fixed an error involving failure to write fill values to the user's
@ -678,11 +686,14 @@ Bug Fixes since HDF5-1.8.0 release
Configuration
-------------
- When CMake commands are executed individually on the command line and the
external filters are being built, the CMAKE_BUILD_TYPE define must be set
to the same value as the configuration
- CMake: When CMake commands are executed individually on the command line
and the external filters are being built, the CMAKE_BUILD_TYPE define
must be set to the same value as the configuration
(-DCMAKE_BUILD_TYPE:STRING=Release if using -C Release). This is needed
by the the szip and zlib filter build commands. (ADB - HDFFV-8695)
- CMake: Remove use of XLATE_UTILITY program. (ADB - 2014/03/28 HDFFV-8640)
- CMake: Added missing quotes in setting the CMAKE_EXE_LINKER_FLAGS for the
MPI option. (ADB - 2014/02/27 HDFFV-8674)
- Modified H5detect.c to scan floating point types for padding bits before
analyzing the type further. This should fix problems with gcc 4.8
(NAF - 2013/09/19 - HDFFV-8523/HDFFV-8500)
@ -786,6 +797,10 @@ Bug Fixes since HDF5-1.8.0 release
Tools
-----
- h5repack: h5repack would not attempt to remove UD filters. Added a
check to h5repack for UD filters that checks if the filter can
be dynamically loaded. This will require a change in the library to
add the H5PL_load() to the H5Zfilter_avail(). (ADB - 2014/03/03 HDFFV-8629)
- h5repack: Fixed failure for converting a layout of small chunked dataset
(size < 1K) to contiguous layout. HDFFV-8214 (JKM 2013/03/18)
- h5diff: Fixed to return correct exit code 1 when detect unique extra

2
release_docs/USING_CMake_Examples.txt
View File

@ -22,7 +22,7 @@ I. Preconditions
1. We suggest you obtain the latest CMake for windows from the Kitware
web site. The HDF5 1.8.x product requires a minimum CMake version
of 2.8.10.
of 2.8.12.
2. You have installed the HDF5 library built with CMake, by executing
the HDF Install Utility (the *.exe file in the binary package for

13
release_docs/USING_HDF5_CMake.txt
View File

@ -95,22 +95,15 @@ These steps are described in more detail below.
cmake -G "<generator>" [-D<options>] <sourcepath>
Where <generator> is
* Borland Makefiles
* MSYS Makefiles
* MinGW Makefiles
* NMake Makefiles
* Unix Makefiles
* Visual Studio 12
* Visual Studio 12 Win64
* Visual Studio 11
* Visual Studio 11 Win64
* 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
@ -138,7 +131,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 10" -DBUILD_TESTING:BOOL=ON -DUSE_SHARED_LIBS:BOOL=ON ..
cmake -G "Visual Studio 11" -DBUILD_TESTING:BOOL=ON -DUSE_SHARED_LIBS:BOOL=ON ..
3. Build HDF5 Applications