summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
authorAllen Byrne <byrn@hdfgroup.org>2014-06-11 18:51:18 (GMT)
committerAllen Byrne <byrn@hdfgroup.org>2014-06-11 18:51:18 (GMT)
commit0c07b68c92998073a51ec4958a87c6b7f0b2cb8e (patch)
tree175e59f42e64ae092d03989a143c63c8e007416b /release_docs
parentd86717819242c706a34abf2d2bdb64baebfe1818 (diff)
downloadhdf5-0c07b68c92998073a51ec4958a87c6b7f0b2cb8e.zip
hdf5-0c07b68c92998073a51ec4958a87c6b7f0b2cb8e.tar.gz
hdf5-0c07b68c92998073a51ec4958a87c6b7f0b2cb8e.tar.bz2
[svn-r25260] Update versions
Diffstat (limited to 'release_docs')
-rw-r--r--release_docs/INSTALL_Cygwin.txt81
1 files changed, 53 insertions, 28 deletions
diff --git a/release_docs/INSTALL_Cygwin.txt b/release_docs/INSTALL_Cygwin.txt
index a7e5f67..a56895a 100644
--- a/release_docs/INSTALL_Cygwin.txt
+++ b/release_docs/INSTALL_Cygwin.txt
@@ -2,14 +2,20 @@
HDF5 Build and Install Instructions for Cygwin
************************************************************************
+This document is a instruction on how to build, test and install HDF5 libary on
+Cygwin. See detailed information in hdf5/INSTALL.
+
+NOTE: hdf5 can be built with CMake, see the INSTALL_CMake.txt file for more guidance.
+
Preconditions:
--------------
-1. Installed Cygwin 1.7.15 or higher
+1. Installed Cygwin 1.7.25 or higher
To install the Cygwin net release, go to http://www.cygwin.com and
- click on "Install or update now!" icon. This will download a GUI
- installer called setup.txt which can be run to download a complete
+ click on "setup-x86.exe" (32-bit installation) under the heading
+ "Current Cygwin DLL version". This will download a GUI
+ installer called setup-x86.exe which can be run to download a complete
Cygwin installation via the internet. Then follow the instructions
on each screen to install Cygwin.
@@ -18,42 +24,46 @@ Preconditions:
http://www.cygwin.com/packages/ provides detailed information about
Cygwin packages.
- To build HDF5 on Cygwin, Devel package (including gcc,gcc-g++,
- gcc-gfortran, and gcc-java compiles, and gdb tool) should be installed.
+ Most required dependencies can be satisfied by installing all packages in
+ the "Devel" category. However, please verify that you have installed all
+ packages listed below.
-2. Compilers Installed
+2. Compilers, Libraries and Utilities Installed
- 2.1 C/C++ Compilers HDF5-1.8 Supported
-
- gcc (4.5.3), which includes:
+ 2.1 Compilers Supported
+
+ The following compilers are supported by HDF5 and included in the Cygwin
+ package system:
+ gcc (4.7.3), which includes:
gcc4-core : C compiler
gcc4-g++ : C++ compiler
gcc4-fortran : fortran compiler
+
- 2.2 Using Compilers Not Supported
-
- The compilers in 2.1 are supported and tested by HDF
- group. Any other compilers may still work but they are not
- guaranteed by HDF group.
-
- If users want to use other compilers except those in 2.1,
- try to set the following variables to override the default
- choices.
+ 2.1.1 Using Compilers Not Supported
- CXX : C++ compiler command
- FC : Fortran compiler command
+ By default the current configuration uses vendor compilers; to use
+ another compiler run the following commands before running
+ configure:
+
+ setenv CC "foo -flags"
+ setenv FC "fffoo -flags"
For example, if users want to use pgf90 as fortran compiler, then
setenv FC pgf90
-
-3. HDF5 Dependencies
- 3.1 Zlib
+ See the configure help page (configure --help) for a list of
+ environment variables that have an affect on building the
+ library.
+
+ 2.2 HDF5 External Library Dependencies
+
+ 2.2.1 Zlib
- zlib-1.2.5 or later is supported and tested on Cygwin.
+ zlib-1.2.5 or later is supported and tested on Cygwin.
- 3.2 Szip
+ 2.2.2 Szip
The HDF5 library has a predefined compression filter that uses
the extended-Rice lossless compression algorithm for chunked
datatsets. For more information about Szip compression and
@@ -64,9 +74,24 @@ Preconditions:
ftp://ftp.hdfgroup.org/lib-external/szip/2.1. Binary distribution can be
found under ftp://ftp.hdfgroup.org/lib-external/szip/2.1/bin/cygwin
-
-Install HDF5 on Cygwin
-----------------------
+
+ 2.3 Additional Utilities
+
+ The following standard utilities are also required to build and test HDF5:
+
+ bison : yacc implementation
+ flex : flex utility
+ make : make utility
+
+ 2.4 Alternate Build Process
+
+ Download the CMake package and follow the notes in the "INSTALL_CMake.txt"
+ file to build HDF5 with the CMake utilities.
+
+
+
+Build, Test and Install HDF5 on Cygwin
+--------------------------------------
1. Get HDF5 source code package
Users can download HDF5 source code package from HDF website