From d314b58010461a51a9043ad58fc9364dace40a34 Mon Sep 17 00:00:00 2001 From: Allen Byrne Date: Wed, 26 May 2010 11:47:12 -0500 Subject: [svn-r18903] Renamed Cmake specific document, making more general for all platforms. Updated references in other files. --- release_docs/CMake.txt | 111 +++++++++++++++++++++ release_docs/CMake_Windows.TXT | 95 ------------------ release_docs/INSTALL_Windows.txt | 2 +- release_docs/INSTALL_Windows_From_Command_Line.txt | 2 +- 4 files changed, 113 insertions(+), 97 deletions(-) create mode 100755 release_docs/CMake.txt delete mode 100755 release_docs/CMake_Windows.TXT diff --git a/release_docs/CMake.txt b/release_docs/CMake.txt new file mode 100755 index 0000000..8a9dd03 --- /dev/null +++ b/release_docs/CMake.txt @@ -0,0 +1,111 @@ +************************************************************************ +* Build and Install HDF5 C/C++ Library with CMake * +************************************************************************ + +Notes: This short instruction is written for users who want to quickly build + HDF5 library and tools 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. CMake is being introduced in this release as early-access. While + we have attempted to provide error-free files, please understand + that this development with CMake has just began. The CMake + specific files may change before the next release. + + +======================================================================== + 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.1. + + 2. If you plan to use Zlib or Szip, download the packages and install them + in a central location. For example on Windows, create a folder extlibs + and install the packages there. Windows users should also read Section V + in INSTALL_Windows.txt. + +======================================================================== + Building HDF5 C/C++ Libraries 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). + + 2. Configure the cache settings + + 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. + + 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. + + 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. + + 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. + + 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. + + 5. The files that support building HDF5 with CMake are all the files in the + Resources folder, the CMakeLists.txt files in each source folder, and two + additional files, ConfigureChecks.cmake and CTestConfig.cmake. The + CTestConfig.cmake is specific to the internal testing performed by The HDF + Group. It should be altered for the users installation and needs. + + 6. More information about using CMake can be found at the KitWare site, + www.cmake.org. + + +************************************************************************ + +Need further assistance, send email to help@hdfgroup.org + diff --git a/release_docs/CMake_Windows.TXT b/release_docs/CMake_Windows.TXT deleted file mode 100755 index 044311c..0000000 --- a/release_docs/CMake_Windows.TXT +++ /dev/null @@ -1,95 +0,0 @@ -************************************************************************ -* Build and Install HDF5 C/C++ Library with CMake on Windows * -************************************************************************ - -Notes: This short instruction is written for users who want to quickly build - HDF5 library and tools from the HDF5 source code package using the CMake - tools on Windows with the Visual Studio product. - - For detailed HDF5 build and install information, or if you have trouble - following any steps in the instructions, please refer to - INSTALL_Windows.txt for further information. - - For users who would like to build and test HDF5 package from the - command line, please refer to INSTALL_Windows_From_Command_Line.txt. - - Notes: - - 1. CMake is being introduced in this release as early-access. While we - have attempted to provide error-free files, please understand that - this development with CMake has just began. - - 2. Testing of some tools have issues. - The following are failing sometimes on windows - hl_test_ds - - -======================================================================== - 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. - - If you plan to use Zlib or Szip, download the packages and install them - in a central location. For example, create a folder extlibs and install - the packages there. You should also read Section V in INSTALL_Windows.txt. - -======================================================================== - Building HDF5 C/C++ Libraries with CMake -======================================================================== - - 1. Run CMake - - The CMake executable is name "cmake-gui.exe" and should be available in - your Start menu. Specify the source and build directories. It is - recommemded that you choose a build directory different then the source - directory (for example, if the source is at c:\MyHDFstuff\hdf5, then - use c:\MyHDFstuff\hdf5\build or c:\MyHDFstuff\build\hdf5). - - 2. Configure the cache settings - - 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, 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, click the - Generate button to produce the appropriate build files (if you are using - a Visual Studio generator, solution and project files will be created). - - - 3. Build HDF5 - - You can build HDF5 using either the Visual Studio Environment or the command line. - - 3.1 If you wish to use the Visual Studio environment, open the solution file - in your build directory. - - 3.2 To build from the command line, navigate to your build directory and - execute the following; - - cmake --build . --config {Debug | Release} - - - 4. Test HDF5. - - To test the build, navigate to your build directory and execute; - - ctest . -C {Debug | Release} - - 5. The files that support building HDF5 with CMake are all the files in the Resources - folder, the CMakeLists.txt files in each source folder, and two additional files, - ConfigureChecks.cmake and CTestConfig.cmake. The CTestConfig.cmake is specific to - the internal testing performed by The HDF Group. It should be altered for the users - installation and needs. - - 6. More information about using CMake can be found at the KitWare site, www.cmake.org. - - -************************************************************************ - -Need further assistance, send email to help@hdfgroup.org - diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index f6f79f2..6ab8f0b 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -179,7 +179,7 @@ Notes: line, please read INSTALL_Windows_From_Command_Line.txt. 5. For users who would like to build and test HDF5 package using CMake, - please read INSTALL_Windows_Using_CMake.txt. + please read CMake.txt. 6. HDF4-related tools are not built and released with HDF5 library packages any more. To obtain HDF4 related tools, please check diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index 19f7be5..7557441 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -13,7 +13,7 @@ Note: This instruction is written for users who would like to build HDF5 Microsoft Visual Studio 2008 for 32- or 64-bit Windows. 2. Building and testing HDF5 C/C++/Fortran libraries and utilities using - CMake tools. Refer to CMAKE_Windows.txt file for detailed information. + CMake tools. Refer to the CMAKE.txt file for detailed information. For all other Windows development tools, HDF5 should be built in the development environment. Please refer to INSTALL_Windows.txt -- cgit v0.12