summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
authorAllen Byrne <byrn@hdfgroup.org>2010-05-26 16:47:12 (GMT)
committerAllen Byrne <byrn@hdfgroup.org>2010-05-26 16:47:12 (GMT)
commitd314b58010461a51a9043ad58fc9364dace40a34 (patch)
tree00cb437c514ceacec6e73e53d8963bd9f64f11c1 /release_docs
parent60790e60925ed6c2f29082658e88d3d048e8a45b (diff)
downloadhdf5-d314b58010461a51a9043ad58fc9364dace40a34.zip
hdf5-d314b58010461a51a9043ad58fc9364dace40a34.tar.gz
hdf5-d314b58010461a51a9043ad58fc9364dace40a34.tar.bz2
[svn-r18903] Renamed Cmake specific document, making more general for all platforms. Updated references in other files.
Diffstat (limited to 'release_docs')
-rwxr-xr-xrelease_docs/CMake.txt111
-rwxr-xr-xrelease_docs/CMake_Windows.TXT95
-rw-r--r--release_docs/INSTALL_Windows.txt2
-rwxr-xr-xrelease_docs/INSTALL_Windows_From_Command_Line.txt2
4 files changed, 113 insertions, 97 deletions
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