diff options
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/INSTALL_MinGW.txt | 62 | ||||
-rw-r--r-- | release_docs/RELEASE.txt | 5 |
2 files changed, 32 insertions, 35 deletions
diff --git a/release_docs/INSTALL_MinGW.txt b/release_docs/INSTALL_MinGW.txt index ee1518e..9191ea9 100644 --- a/release_docs/INSTALL_MinGW.txt +++ b/release_docs/INSTALL_MinGW.txt @@ -5,21 +5,19 @@ Preconditions:
--------------
-1. Installed MinGW (5.1.4 or higher) and MSYS (1.0.10 or higher)
+1. Installed MinGW (5.1.6 or higher) and MSYS (1.0.11 or higher)
To install the MinGW net release, go to http://www.mingw.org 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
- MinGW installation via the internet. Then follow the instructions
- on each screen to install MinGW.
+ follow the instructions for a manual installation.
2. Compilers Installed
- 2.1 C/C++ Compilers HDF5-1.8.3 Supported
+ 2.1 C/C++ Compilers HDF5-1.8.4 Supported
- gcc-3.4.2 is included in MinGW, which includes:
+ gcc-4.4.0 is included in MinGW, which includes:
gcc : GNU C compiler
gcc-g++: GNU C++ compiler
+ gfortran: GNU Fortran compiler
2.2 Using Compilers Not Supported
@@ -63,29 +61,29 @@ Build HDF5 on MinGW The HDF5 source code is distributed in a variety of formats which
can be unpacked with the following commands, each of which creates
- an `hdf5-1.8.3' directory.
+ an `hdf5-1.8.4' directory.
2.1 Non-compressed tar archive (*.tar)
- $ tar xf hdf5-1.8.3.tar
+ $ tar xf hdf5-1.8.4.tar
2.2 Gzip'd tar archive (*.tar.gz)
- $ gunzip < hdf5-1.8.3.tar.gz | tar xf -
+ $ gunzip < hdf5-1.8.4.tar.gz | tar xf -
2.3 Bzip'd tar archive (*.tar.bz2)
- $ bunzip2 < hdf5-1.8.3.tar.bz2 | tar xf -
+ $ bunzip2 < hdf5-1.8.4.tar.bz2 | tar xf -
3. Setup Environment
- Building HDF5 1.8.3 requires an explicit link to libws2_32.a
+ Building HDF5 1.8.4 requires an explicit link to libws2_32.a
to handle Windows Sockets. To do this, issue the command:
$ export LIBS=-lws2_32
Also, the default search path can cause trouble using ./configure in HDF5
- 1.8.3. Check that non-MinGW or non-msys directories are not added to the
+ 1.8.4. Check that non-MinGW or non-msys directories are not added to the
PATH. You can do this by:
$ echo $PATH
@@ -128,36 +126,28 @@ Build HDF5 on MinGW Do this for the following Makefiles and tests:
- - ./test/Makefile.in: "testerror.sh"
-
- - ./tools/h5dump/Makefile.in: "testh5dump.sh" and "testh5dumpxml.sh"
+ - ./test/Makefile.in: "testerror.sh testlibinfo.sh testcheckinfo.sh"
- ./tools/h5diff/Makefile.in: "testh5diff.sh"
+ - ./tools/h5ls/Makefile.in: "testh5ls.sh"
+
- ./tools/misc/Makefile.in: "testh5mkgrp.sh"
- ./tools/h5copy/Makefile.in: "testh5copy.sh"
- - ./tools/h5ls/Makefile.in: "testh5ls.sh"
-
- ./tools/h5stat/Makefile.in: "testh5stat.sh"
+ - ./tools/h5dump/Makefile.in: "testh5dump.sh" and "testh5dumpxml.sh"
+
6. Configuring
Notes:
- 1) Building Fortran libraries is also currently unsupported. This is
- because the current release of gcc for mingw (3.4.5) is not compatible
- with the current g95 for mingw (g95 0.91!, gcc version 4.0.3).
-
- However, MinGW offers versions of gcc 4.x as a "Technology Preview"
- or "Testing" release. These should be compatible with the latest
- MinGW g95, but is untested. Keep in mind that this is UNSUPPORTED,
- and any Fortran binaries build should be considered experimental.
+ 1) Note: MinGW is c++ package is missing the libstdc++.dll.a file
+ and c++ linking fails. Do not enable c++ option in configure.
- 2) Shared libraries can not be built on MinGW in release 1.8.3.
-
- 3) See detailed information in hdf5/release_docs/INSTALL,
+ 2) See detailed information in hdf5/release_docs/INSTALL,
part 5. Full installation instructions for source
distributions
@@ -169,7 +159,7 @@ Build HDF5 on MinGW If you would like to build the C++ library, add the parameter:
- --enable-cxx
+ --enable-cxx (12-11-2009 MinGW C++ package is missing a file)
If you would like to build without the Zlib library, add the parameter:
@@ -210,15 +200,15 @@ Build HDF5 on MinGW Combination of Switches
All of the above switches can be combined together. For
- example, if users want to configure HDF5 C/C++
+ example, if users want to configure HDF5 C/Fortran
library, with zlib library at /c/usr/, and
install HDF5 into directory /c/hdf5 using
- gcc/g++ as C/C++ compiler:
+ gcc/gfortran as C/Fortran compiler:
$ ./configure
--with-zlib=/usr/include,/usr/lib
--prefix=/c/hdf5
- --enable-cxx
+ --enable-fortran
<"If no more switches, then hit Enter">
Notes: The command format above is for readilibity. In practice,
@@ -234,7 +224,7 @@ Build HDF5 on MinGW $ ./configure
--prefix=/c/hdf5
- --enable-cxx
+ --enable-fortran
<"If no more switches, then hit Enter">
7. Make and Make Check
@@ -255,9 +245,11 @@ Build HDF5 on MinGW 9. Check installed HDF5 library
- After step 4, go to your installation directory, there should be
+ After step 8, go to your installation directory, there should be
three subdirectories: "bin" "include" and "lib".
+ $ make installcheck > "output file name"
+
-----------------------------------------------------------------------
Need Further assistance, email help@hdfgroup.org
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt index cb5ec6f..91d7d1e 100644 --- a/release_docs/RELEASE.txt +++ b/release_docs/RELEASE.txt @@ -240,6 +240,7 @@ The following platforms and compilers have been tested for this release. Windows XP Visual Studio .NET Visual Studio 2005 w/ Intel Fortran 9.1 Cygwin(native gcc compiler and g95) + MinGW(5.1.6 with gcc 4.4.0) Windows XP x64 Visual Studio 2005 w/ Intel Fortran 9.1 @@ -319,6 +320,10 @@ Cray XT3 2.0.62 n n n n Known Problems ============== +* MinGW has a missing libstdc++.dll.a library file and will not successfully link + C++ applications/tests. Do not use the enable-cxx configure option. Read all of + the INSTALL_MINGW.txt file for all restrictions. ADB - 2009/11/11 + * Parallel mode in AIX will fail some of the testcheck_version.sh tests where it treats "exit(134) the same as if process 0 had received an abort signal. This is fixed and will be available in the next release. AKC - 2009/11/3 |