[svn-r25648] Update cygwin install doc with better information contained in the trunk version.

Added debug VFD tests to known problems.
Checked versions of windows and extra linux VMs.

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