[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

4 files changed, 159 insertions, 32 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
diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt
index 62c3daa..053ae72 100755
--- a/release_docs/INSTALL_Windows_From_Command_Line.txt
+++ b/release_docs/INSTALL_Windows_From_Command_Line.txt
@@ -6,10 +6,10 @@ Note: This instruction is written for users who would like to build HDF5
       libraries and tools from the HDF5 source code package on command
       line.
          
-      Currently, we support 
+      Currently, we support:
       
       1. Building and testing HDF5 C/C++/Fortran libraries on command line with 
-         Microsoft Visual Studio 2005 for 32- or 64-bit Windows.
+         Microsoft Visual Studio .NET, 2005 or 2008 for 32- or 64-bit Windows.
       
       For all other Windows development tools, HDF5 should be built in
       the development environment.  Please refer to INSTALL_Windows.txt
@@ -25,12 +25,12 @@ notes in INSTALL_Windows.txt before starting below procedures.
 
 ========================================================================
    Section I: Building and testing HDF5 on command line with Microsoft 
-              Visual Studio 2005
+              Visual Studio
 ========================================================================
     
 1. Preconditions: 
 
-   1.1 Verify environment for Visual Studio 2005
+   1.1 Verify environment for Visual Studio
    
    Building from the command line requires environment variables for Visual
    Studio.  These are generally setup when Visual Studio is installed, but you
@@ -41,6 +41,9 @@ notes in INSTALL_Windows.txt before starting below procedures.
     This should output a path similar to:
     
         C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\
+        
+    If you are using Visual Studio .NET, replace "vs80comntools" with
+    "vs71comntools".  For Visual Studio 2008, use "vs90comntools"
       
    1.2 Run batch file copy_hdf.bat.
 
@@ -55,9 +58,9 @@ notes in INSTALL_Windows.txt before starting below procedures.
    From the command prompt that you will be building HDF5 from, issue the
    following command:
    
-        set HDF5_EXT_ZLIB=zdll.lib
+        set HDF5_EXT_ZLIB=zlib1.lib
         
-    replacing "zdll.lib" with the name of the zlib library on your system.
+    replacing "zlib1.lib" with the name of the zlib library on your system.
     Similarly, set HDF5_EXT_SZIP to the name of the szip library on your system.
     
     (Optional) If you will be building using the /useenv switch, you must also
@@ -80,6 +83,8 @@ notes in INSTALL_Windows.txt before starting below procedures.
         hdf5bt file takes the following options:
               /vs7              Build HDF5 using Visual Studio .NET 2003 
                                 Note: Default is Visual Studio 2005
+              /vs9              Build HDF5 using Visual Studio 2008
+                                Note: Default is Visual Studio 2005
               /fort             Build and test HDF5 with Fortran libraries
               /ivf101           Build HDF5 Fortran using Intel Visual Fortran 10.1
                                 Note: Default is Intel Visual Fortran 9.1
@@ -109,6 +114,8 @@ notes in INSTALL_Windows.txt before starting below procedures.
         hdf55build takes the following options:
               /vs7              Build HDF5 using Visual Studio .NET 2003 
                                 Note: Default is Visual Studio 2005
+              /vs9              Build HDF5 using Visual Studio 2008
+                                Note: Default is Visual Studio 2005
               /fort             Build HDF5 with Fortran libraries
               /ivf101           Build HDF5 Fortran using Intel Visual Fortran 10.1
                                 Note: Default is Intel Visual Fortran 9.1
diff --git a/windows/hdf5bt.BAT b/windows/hdf5bt.BAT
index 555d715..dd48f10 100755
--- a/windows/hdf5bt.BAT
+++ b/windows/hdf5bt.BAT
@@ -18,6 +18,8 @@ rem This batch file is used to build and test HDF5 Libraries and Tools.
 rem This batch file takes the following options:

 rem .  /vs7              Build HDF5 using Visual Studio .NET 2003 

 rem .                    Note: Default is Visual Studio 2005

+rem .  /vs9              Build HDF5 using Visual Studio 2008

+rem .                    Note: Default is Visual Studio 2005

 rem .  /fort             Build and test HDF5 with Fortran libraries

 rem .  /useenv           Build HDF5 using compiler settings defined

 rem .                    in the environment, rather than the IDE.

@@ -29,7 +31,7 @@ rem .                      HDF5CHECK_LOG
 rem .  /?                Help information

 rem By Xuan Bai

 rem Created: Aug. 16, 2004

-rem Last Updated: Scott Wegner, 6/30/08

+rem Last Updated: Scott Wegner, 7/2/08

 

 rem This batch file makes the following assumptions:

 rem    - The appropriate version of Visual Studio is installed and setup

@@ -63,6 +65,8 @@ rem Print a help message
     echo.

     echo.   /vs7              Build HDF5 using Visual Studio .NET 2003 

     echo.                     Note: Default is Visual Studio 2005

+    echo.   /vs9              Build HDF5 using Visual Studio 2008

+    echo.                     Note: Default is Visual Studio 2005

     echo.   /fort             Build and test HDF5 with Fortran libraries

     echo.   /ivf101           Build HDF5 Fortran using Intel Visual Fortran 10.1

     echo.                     Note: Default is Intel Visual Fortran 9.1

@@ -81,6 +85,10 @@ rem Parse through the parameters sent to file, and set appropriate variables
             rem Use Visual Studio .NET to build

             set hdf5_vnet=true

     

+        ) else if "%%a"=="/vs9" (

+            rem Use Visual Studio 2008 to build

+            set hdf5_vs2008=true

+            

         ) else if "%%a"=="/fort" (

             rem Enable Fortran

             set hdf5_enablefortran=true

@@ -125,6 +133,10 @@ rem Setup our environment
         set hdf5build_params=%hdf5build_params% /vs7

     )

     

+    if defined hdf5_vs2008 (

+        set hdf5build_params=%hdf5build_params% /vs9

+    )

+

     if defined hdf5_enablefortran (

         set hdf5build_params=%hdf5build_params% /fort

         set hdf5check_params=enableall

diff --git a/windows/hdf5build.BAT b/windows/hdf5build.BAT
index 3a6d641..abb6c90 100755
--- a/windows/hdf5build.BAT
+++ b/windows/hdf5build.BAT
@@ -18,6 +18,8 @@ rem This batch file is used to build HDF5 Libraries and Tools.
 rem This batch file takes the following options:

 rem .  /vs7              Build HDF5 using Visual Studio .NET 2003 

 rem .                    Note: Default is Visual Studio 2005

+rem .  /vs9              Build HDF5 using Visual Studio 2008

+rem .                    Note: Default is Visual Studio 2005

 rem .  /fort         Build HDF5 with Fortran libraries

 rem .   /ivf101             Build HDF5 Fortran using Intel Visual Fortran 10.1

 rem .                       Note: Default is Intel Visual Fortran 9.1

@@ -26,7 +28,7 @@ rem .                    in the environment, rather than the IDE.
 rem .  /?                Help information

 rem By Xuan Bai

 rem Created: Aug. 16, 2004

-rem Last Updated: Scott Wegner, 6/30/08

+rem Last Updated: Scott Wegner, 7/2/08

 

 rem This batch file makes the following assumptions:

 rem    - The appropriate version of Visual Studio is installed and setup

@@ -58,6 +60,8 @@ rem Print a help message
     echo.

     echo.   /vs7                Build HDF5 using Visual Studio .NET 2003 

     echo.                       Note: Default is Visual Studio 2005

+    echo.   /vs9                Build HDF5 using Visual Studio 2008

+    echo.                       Note: Default is Visual Studio 2005

     echo.   /fort               Build HDF5 with Fortran libraries using the

     echo.                       Intel Fortran version specified, or 9.1 by default

     echo.   /ivf101             Build HDF5 Fortran using Intel Visual Fortran 10.1

@@ -77,6 +81,10 @@ rem Parse through the parameters sent to file, and set appropriate variables
             rem Use Visual Studio .NET 2003

             set hdf5_vnet=true

             

+        ) else if "%%a"=="/vs9" (

+            rem Use Visual Studio .NET 2003

+            set hdf5_vs2008=true

+            

         ) else if "%%a"=="/fort" (

             rem Enable Fortran

             set hdf5_enablefortran=true

@@ -123,11 +131,26 @@ rem Setup our environment
             exit /b 1

         )

     )

+    rem Make sure /vs7 and /vs9 weren't specified together

+    if "%hdf5_vnet%%hdf5_vs2008%"=="truetrue" (

+        echo.Error: /vs7 and /vs9 should not be specified together.

+        exit /b 1

+    )

 

     rem Figure out which solution file to use based on configuration

     if defined hdf5_vnet (

         echo.Using Visual Studio .NET 2003

-            set hdf5_sln="%CD%\windows_vnet\proj\all\all.sln"

+        set hdf5_sln="%CD%\windows_vnet\proj\all\all.sln"

+        

+    ) else if defined hdf5_vs2008 (

+        echo.Using Visual Studio 2008

+        if defined hdf5_enablefortran (

+            echo.Building Fortran projects enabled

+            set hdf5_sln="%CD%\windows\proj\all_fortran\all_fortran.sln"

+        ) else (

+            set hdf5_sln="%CD%\windows\proj\all\all.sln"

+        )

+        

     ) else (

         echo.Using Visual Studio 2005

         if defined hdf5_enablefortran (

@@ -164,6 +187,42 @@ rem Setup our environment
             echo.make sure VS71COMNTOOLS is defined in the environment.

             exit /b 1

         )

+        

+    ) else if defined hdf5_vs2008 (

+        if not defined hdf5_enablefortran (

+            if defined vs90comntools (

+                rem This sets the Visual Studio 2005 path and environment variables

+                if %hdf5_platform%==Win32 (

+                    call "%vs90comntools%\..\..\VC\vcvarsall.bat" x86

+                ) else (

+                    call "%vs90comntools%\..\..\VC\vcvarsall.bat" x86_amd64

+                )

+

+            ) else (

+                echo.Error: Cannot setup Visual Studio 2008 environment.  Please

+                echo.make sure VS90COMNTOOLS is defined in the environment.

+                exit /b 1

+            )

+            

+        ) else (

+            echo.with Intel Visual Fortran 10.1

+            

+            if defined ifort_compiler10 (

+                rem This sets the Intel Fortran 10.1 environment, as well as

+                rem setting the appropriate Visual Studio environment

+                

+                if %hdf5_platform%==Win32 (

+                    call "%ifort_compiler10%\IA32\Bin\ifortvars.bat"

+                ) else (

+                    call "%ifort_compiler10%\em64t\Bin\ifortvars.bat"

+                )

+            ) else (

+                echo.Error: Cannot setup Intel Fortran 10.1 environment.  Please

+                echo.make sure IFORT_COMPILER10 is defined in the environment.

+                exit /b 1

+            )

+        )

+        

     ) else (

         rem Assume Visual Studio 2005

         if not defined hdf5_enablefortran (

@@ -204,7 +263,7 @@ rem Setup our environment
                 echo.with Intel Visual Fortran 10.1

                 

                 if defined ifort_compiler10 (

-                    rem This sets the Intel Fortran 9.1 environment, as well as

+                    rem This sets the Intel Fortran 10.1 environment, as well as

                     rem setting the appropriate Visual Studio environment

                     

                     if %hdf5_platform%==Win32 (

@@ -231,6 +290,15 @@ rem Setup our environment
     exit /b 0

 

 

+rem Upgrade the project files to the latest format for Visual Studio

+:upgrade

+    

+    echo.Upgrading project files

+    devenv %hdf5_sln% /Upgrade /NoLogo

+    

+    exit /b

+

+

 rem Build the HDF5 libraries.  By default, C and C++ libraries are built.

 :all

 

@@ -244,8 +312,7 @@ rem Build the HDF5 libraries.  By default, C and C++ libraries are built.
     rem Build both debug and release versions

     for %%a in (debug release) DO (

         echo.Building %hdf5_platform% %%a libraries...

-        rem Only add hdf5_platform if using Visual Studio 2005, because Visual Studio

-        rem .NET doesn't like the syntax

+        rem Only add hdf5_platform if not using Visual Studio .NET, because it doesn't like the syntax

         if defined hdf5_vnet (

             devenv %hdf5_sln% %ccflags% /rebuild %%a

         ) else (

@@ -291,6 +358,15 @@ rem This is where the magic happens
         echo.Error setting up build environment.

         goto error

     )

+    

+    rem Upgrade the project files if needed

+    if defined hdf5_vs2008 (

+        call :upgrade

+        if !errorlevel! neq 0 (

+            echo.Error upgrading project files!

+            goto error

+        )

+    )

 

     echo.Building HDF5 Libraries and Tools

     echo.