[svn-r15312] Purpose: Support Visual Studio 2008 on Windows

Description:
Write documentation for building HDF5 with the latest version of Visual Studio, 2008.  The process is very similar to building with Visual Studio 2005, but with an automatic project-file conversion beforehand.

Also adapt commandline build scripts for Visual Studio 2008 as well.

Tested:
VS2008 on WinXP

1 files changed, 52 insertions, 20 deletions

diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt
index 2090f02..6c4a71f 100644
--- a/release_docs/INSTALL_Windows.txt
+++ b/release_docs/INSTALL_Windows.txt
@@ -23,8 +23,9 @@ Contents:
    Section VIII  :  How to build HDF5 with Thread-Safe Feature
    Section IX    :  How to build HDF5 for 64-bit Windows
    Section X     :  How to build HDF5 on Windows Vista
-   Section XI    :  Backwards Compatibility with HDF5 1.6
-   Section XII   :  Misc.
+   Section XI    :  How to build HDF5 using Visual Studio 2008
+   Section XII   :  Backwards Compatibility with HDF5 1.6
+   Section XIII  :  Misc.
 
 
 ========================================================================
@@ -34,10 +35,10 @@ Contents:
 Preconditions:
 
    1. Installed Microsoft Visual Studio.  This document is written for Visual
-      Studio 2005, although we also support Visual Studio .NET 2003.  Most of 
-      the instructions are the same, although some features are unsupported in
-      Visual Studio .NET.  For simple Visual Studio .NET instructions, see the
-      document INSTALL_Windows_NET.TXT.
+      Studio 2005, although we also support Visual Studio .NET 2003 and Visual
+      Studio 2008 as well.  Most of the instructions are the same, although some
+      features are unsupported in Visual Studio .NET.  For simple Visual Studio 
+      .NET instructions, see the document INSTALL_Windows_NET.TXT.
    
    2. (Optional) Installed Intel Compiler 9.1 or 10.1 if you want to build HDF5 
       Fortran libraries.
@@ -187,6 +188,9 @@ Notes:
    7. For users who would like to build Muti-threaded version of HDF5 library, 
       please read Section VII.
       
+   8. To build HDF5 in Visual Studio 2008, be sure to read the instructions in
+      Section XI.
+      
 
 ========================================================================
                  Section I: What do we build and install?
@@ -1119,6 +1123,8 @@ Notes:  1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are
         2. The Compaq Fortran Compiler is no longer supported for HDF5 1.8.
 
         3. Intel Fortran 9.1 works only under Visual Studio 2005 environments.
+           Building Fortran libraries under Visual Studio .NET is unsupported.
+           Visual Studio 2008 is supported only with Intel Fortran 10.1.
         
         4. Parallel builds should be disabled.  To do so: Go to  Tools > 
            Options > Projects and Solutions > Build and Run. Set "Maximum Number
@@ -1142,7 +1148,7 @@ Notes:  1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are
       You have to read this part even if you want to use only Zlib
       or Szip.  You also need to read Section V.
 
-        1) Invoke Microsoft Visual Studio 2005.  
+        1) Invoke Microsoft Visual Studio 2005 or 2008.
         
         2) From the main menu, Go to Tools > Options > Intel(R) Fortran. In the 
            right panel, make sure your "Selected Compiler" is Intel Fortran.
@@ -1156,15 +1162,15 @@ Notes:  1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are
         5) Then click "OK".
 
       
-1. Build with Intel Fortran Compiler 9.1 or 10.1 under Visual Studio 2005
+1. Build with Intel Fortran Compiler 9.1 or 10.1 under Visual Studio 2005 or 2008
 
   Note: This step will build HDF5 Static and DLL C and C++ Library using
-        Visual Studio 2005 Compiler as well as HDF5 Static and High Level 
+        Visual Studio compiler as well as HDF5 Static and High Level 
         Fortran Library using Intel Fortran 9.1 or 10.1 Compiler.
 
   1.1 Open all_fortran.sln
 
-      Invoke Microsoft Visual Studio 2005.  From the main menu, 
+      Invoke Microsoft Visual Studio.  From the main menu, 
       go to "File" and select "Open Solution".  Choose "all_fortran.sln" 
       under the directory c:\MyHDFstuff\hdf5\windows\proj\all_fortran.
 
@@ -1254,7 +1260,7 @@ Notes:  1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are
 
        1. Open allf90examples.sln
 
-          Invoke Microsoft Visual Studio 2005.  From the main menu, 
+          Invoke Microsoft Visual Studio.  From the main menu, 
           go to "File" and select "Open Solution".  Choose "allf90examples.sln" 
           under the directory 
           c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples.
@@ -1319,7 +1325,7 @@ Notes:  1. For Intel Compiler users, Intel fortran Compiler 9.1 and 10.1 are
 
        1. Open allhlf90examples.sln
 
-          Invoke Microsoft Visual Studio 2005.  From the main menu, 
+          Invoke Microsoft Visual Studio.  From the main menu, 
           go to "File" and select "Open Solution".  Choose 
           "allhlf90examples.sln" under the directory 
           c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\allhlf90examples.        
@@ -1614,10 +1620,10 @@ to the earlier sections of this document for details on building and testing.
             Section IX: How to build HDF5 for 64-bit Windows
 ========================================================================
 
-HDF5 can be built for 64-bit Windows in Visual Studio 2005.  Visual Studio .NET
-has very primative 64-bit support, but it is very difficult to setup, and
-debugging is not supported.  Therefore, we recommend all users switch to 
-Visual Studio 2005 for 64-bit builds.  
+HDF5 can be built for 64-bit Windows in Visual Studio 2005 or 2008.  Visual 
+Studio .NET has very primative 64-bit support, but it is very difficult to 
+set up, and debugging is not supported.  Therefore, we recommend all users 
+switch to Visual Studio 2005 or 2008 for 64-bit builds.  
 
 Notes:
   
@@ -1630,7 +1636,7 @@ Prerequisites:
 
     1. A 64-bit Windows machine.  Either AMD64 and Itanium is supported.
     
-    2. Microsoft Visual Studio 2005 installed with x64 Extensions.
+    2. Microsoft Visual Studio 2005 or 2008 installed with x64 Extensions.
            
 
 Building:
@@ -1673,8 +1679,8 @@ Building on Windows Vista is very similar to building on Windows XP, with
 some minor changes.  Therefore, follow the build instructions above, with the
 following considerations:
 
-    1. Only Visual Studio 2005 is currently supported on Windows Vista.  This
-       is because Microsoft has ended their support for 6.0 and .NET.
+    1. Only Visual Studio 2005 and 2008 is currently supported on Windows Vista.
+       This is because Microsoft has ended their support for and .NET.
        
     2. Building Fortran libraries has not been tested, and is therefore also
        unsupported.  You may attempt to build Fortran libraries following the
@@ -1695,6 +1701,32 @@ following considerations:
 
 
 ========================================================================
+            Section XI: How to build HDF5 using Visual Studio 2008
+========================================================================
+Building with Visual Studio 2008 is very similar to building with Visual Studio
+2005, with some minor changes.  Therefore, follow the build instructions above, 
+with the following considerations:
+
+    1. Visual Studio 2008 uses a new format for project files, but Visual Studio
+       2005 project files can be easily converted.  The HDF5 project files
+       will need to be converted on first use.  To do so:
+       
+       1.1. Open the HDF5 Visual Studio 2005 solution file as in Section II
+            (either all.sln or all_fortran.sln if building Fortran.)
+            
+       1.2. You will be prompted with an automatic conversion wizard.  Click
+            through, accepting the default values.  You may choose to create
+            backups of the project files, although it isn't necessary.
+            
+       1.3. When it is finished, it should state that all projects were
+            converted successfully with no errors.  Warnings can be ignored.
+            
+    2. Once the project files have been converted, build and test normally.
+       Note that the converted project files aren't backwards compatible with
+       previous versions of Visual Studio.
+
+
+========================================================================
         Section XII: Backwards Compatibility with HDF5 1.6
 ========================================================================
 
@@ -1725,7 +1757,7 @@ To enable 1.6 API symbols in your application:
 
 
 ========================================================================
-                            Section XII: Misc.
+                            Section XIII: Misc.
 ========================================================================
 
 1. Helpful Pointers