[svn-r17990] Tested MinGW environment on XP32 with latest environment and gcc 4.4.0 tools.

Tested: Windows XP 32bit

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