From 16bb687b00986eff1b04f7791bbb8bf7efc3ea0a Mon Sep 17 00:00:00 2001 From: Allen Byrne Date: Tue, 1 Jun 2010 15:34:26 -0500 Subject: [svn-r18940] Update Cygwin and Windows references Removed support for MinGW --- release_docs/INSTALL_MinGW.txt | 263 ----------------------------------------- release_docs/RELEASE.txt | 30 ++--- 2 files changed, 16 insertions(+), 277 deletions(-) delete mode 100644 release_docs/INSTALL_MinGW.txt diff --git a/release_docs/INSTALL_MinGW.txt b/release_docs/INSTALL_MinGW.txt deleted file mode 100644 index 75ef07f..0000000 --- a/release_docs/INSTALL_MinGW.txt +++ /dev/null @@ -1,263 +0,0 @@ -************************************************************************ - HDF5 Build and Install Instructions for MinGW -************************************************************************ - -Preconditions: --------------- - -1. Installed MinGW (5.1.4 or higher) and MSYS (1.0.10 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. - -2. Compilers Installed - - 2.1 C/C++ Compilers HDF5-1.8.1 Supported - - gcc-3.4.2 is included in MinGW, which includes: - gcc : GNU C compiler - gcc-g++: GNU C++ compiler - - 2.2 Using Compilers Not Supported - - The compilers in 2.1 are supported and tested by The 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. - - CC : C compiler command - CXX : C++ compiler command - FC : Fortran compiler command - -3. HDF5 Dependencies - - 3.1 Zlib - - zlib-1.2.2 or later is supported and tested on MinGW. - - 3.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 - license terms see - http://hdfgroup.org/HDF5/doc_resource/SZIP/index.html. - - Szip is currently not supported on MinGW, although we plan to add - support in the future. - - -Build HDF5 on MinGW ----------------------- - -1. Get HDF5 source code package - Users can download HDF5 source code package from HDF website - (http://hdfgroup.org). - -2. Unpacking the distribution - - 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.1' directory. - - 2.1 Non-compressed tar archive (*.tar) - - $ tar xf hdf5-1.8.1.tar - - 2.2 Gzip'd tar archive (*.tar.gz) - - $ gunzip < hdf5-1.8.1.tar.gz | tar xf - - - 2.3 Bzip'd tar archive (*.tar.bz2) - - $ bunzip2 < hdf5-1.8.1.tar.bz2 | tar xf - - -3. Setup Environment - - Building HDF5 1.8.1 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.1. Check that non-MinGW or non-msys directories are not added to the - PATH. You can do this by: - - $ echo $PATH - - If there are spurious entries, specifically those related to other Windows - compilers or tools, remove them by setting a new PATH without them. For - example, - - $ export PATH=.:/usr/local/bin:/mingw/bin:/bin - - -4. Remove Unsupported Source - - There are some projects which are built by default to test performance on - POSIX systems. They are irrelevent on MinGW, and can cause compiler errors. - - To remove these projects from the build script, open ./perform/Makefile.in - Find all instances of "h5perf_serial", and remove them (along with their - respective extension or targets, if they exist). Then save the file. - - -5. Remove Tests - - When building with MinGW, many tests must be removed from the - test suite run with "make check". This is because of the way - MinGW and Windows handles certain parsing. For example, MinGW - treats any command parameter starting with '/' as a path, and - replaces it with it's root directory on Windows, such as - 'C:\msys\1.0\'. - - To remove the tests, open the given 'Makefile.in' and edit the - line begining with "TEST_SCRIPT = " to remove the test script. - For example, to remove the "testerror.sh" from ./test/Makefile.in: - - 1) Open ./test/Makefile.in - - 2) Find the line "TEST_SCRIPT = $(top_srcdir)/test/testerror.sh" - - 3) Change it to simply read "TEST_SCRIPT =", and save. - - Do this for the following Makefiles and tests: - - - ./test/Makefile.in: "testerror.sh" - - - ./tools/h5dump/Makefile.in: "testh5dump.sh" and "testh5dumpxml.sh" - - - ./tools/h5diff/Makefile.in: "testh5diff.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" - - -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. - - 2) Shared libraries can not be built on MinGW in release 1.8.1. - - 3) See detailed information in hdf5/release_docs/INSTALL, - part 5. Full installation instructions for source - distributions - - In short, - - To configure HDF5 with C Library, use - - $ ./configure - - If you would like to build the C++ library, add the parameter: - - --enable-cxx - - If you would like to build without the Zlib library, add the parameter: - - --without-zlib - - If you would like to specify the the Zlib library, there are two ways: - - Using - - --with-zlib=INCDIR,LIBDIR - - For example, if the zlib library is installed in - /usr, which is the parent directory of directories - "include" and "lib", - - --with-zlib=/usr/include,/usr/lib - - Through the CPPFLAGS and LDFLAGS Variables - - For example, if zlib was installed in the directory - /c/usr then using the following command to configure - HDF5 with zib - - $ export CPPFLAGS=-I/usr/include - $ export LDFLAGS=-L/usr/lib - - If you would like to specify the install directory, add the parameter: - - --prefix="path for installation" - - By default, HDF5 library, header files, examples, and - support programs will be installed in /usr/local/lib, - /usr/local/include, /usr/local/doc/hdf5/examples, and - /usr/local/bin. To use a path other than /usr/local specify - the path with the `--prefix=PATH' switch as in the above - command. - - Combination of Switches - - All of the above switches can be combined together. For - example, if users want to configure HDF5 C/C++ - library, with zlib library at /c/usr/, and - install HDF5 into directory /c/hdf5 using - gcc/g++ as C/C++ compiler: - - $ ./configure - --with-zlib=/usr/include,/usr/lib - --prefix=/c/hdf5 - --enable-cxx - <"If no more switches, then hit Enter"> - - Notes: The command format above is for readilibity. In practice, - please type in the command above with at least one - space between each line, No "Enter" until users finish - the switches and want to run the configure. - - - or do it through CPPFLAGS and LDFLAGS variables: - - $ CPPFLAGS=-I/usr/include \ - $ LDFLAGS=-L/usr/lib \ - - $ ./configure - --prefix=/c/hdf5 - --enable-cxx - <"If no more switches, then hit Enter"> - -7. Make and Make Check - - After configuration is done successfully, run the following series of - commands to build, test and install HDF5 - - $ make > "output file name" - $ make check > "output file name" - - Before run "make install", check output file for "make check", there - should be no failures at all. - -8. Make Install - - $ make install > "output file name" - - -9. Check installed HDF5 library - - After step 4, go to your installation directory, there should be - three subdirectories: "bin" "include" and "lib". - ------------------------------------------------------------------------ - -Need Further assistance, email help@hdfgroup.org diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt index 52d31ad..b1671d3 100644 --- a/release_docs/RELEASE.txt +++ b/release_docs/RELEASE.txt @@ -583,15 +583,15 @@ Platforms Tested Intel(R) C++ Version 8.1 Intel(R) Fortran Compiler Version 8.1 mpich-gm-1.2.5..10-intel-r2 - Windows XP - Visual Studio .NET - Visual Studio 2005 w/ Intel Fortran 9.1 - Cygwin(native gcc compiler and g95) - MinGW(native gcc compiler and g95) - Windows XP x64 - Visual Studio 2005 w/ Intel Fortran 9.1 - Windows Vista - Visual Studio 2005 + + Windows XP Visual Studio 2008 w/ Intel Fortran 10.1 + Cygwin(1.7.5 native gcc compiler and gfortran) + + Windows XP x64 Visual Studio 2008 w/ Intel Fortran 10.1 + + Windows Vista Visual Studio 2008 w/ Intel Fortran 10.1 + + Windows Vista x64 Visual Studio 2008 w/ Intel Fortran 10.1 MAC OS 10.5 (Intel) gcc i686-apple-darwin8-gcc-4.0.1 (GCC) 4.0.1 G95 (GCC 4.0.3 (g95 0.91!) Nov 21 2006) @@ -620,7 +620,8 @@ Cray XT3 (not tested for this release) n n n n n n Windows XP n y(3) n(3) y y y Windows XP x64 n y(3) n(3) y y y -Windows Vista n n n y y y +Windows Vista n y(3) n(3) y y y +Windows Vista x64 n y(3) n(3) y y y Mac OS X 10.5 Intel n y n y y y FreeBSD 6.2 32-bit n n n y y y FreeBSD 6.2 64-bit @@ -648,9 +649,10 @@ AIX-5.2 32-bit n n n x n AIX-5.2 64-bit n n n x n Cray XT3 (not tested for this release) n n n x n -Windows XP y y(3) y y y -Windows XP x64 y y(3) y y y -Windows Vista y n n y y +Windows XP y y(3) y y n +Windows XP x64 y y(3) y y n +Windows Vista y y(3) y y n +Windows Vista x64 y y(3) y y n Mac OS X 10.5 Intel y y y x n FreeBSD 6.2 32-bit y y y x n FreeBSD 6.2 64-bit y y y x n @@ -669,7 +671,7 @@ SuSe Linux 2.6.5 Notes: (1) Using mpich 1.2.6. (2) Using mpich2 1.0.6. - (3) Using Visual Studio 2005 or Cygwin + (3) Using Visual Studio 2008 (Cygwin shared libraries are not supported) (4) With PGI and Absoft compilers. (5) AMD Opteron x86_64 Compiler versions for each platform are listed in the preceding -- cgit v0.12