summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_Windows_Short_NET.TXT
diff options
context:
space:
mode:
authorScott Wegner <swegner@hdfgroup.org>2007-07-02 14:33:47 (GMT)
committerScott Wegner <swegner@hdfgroup.org>2007-07-02 14:33:47 (GMT)
commitdb3943af6a9473c8a3f5e78018df53b8019e872a (patch)
tree7926cb9aa1e8d710128668112d79e01ff4682a44 /release_docs/INSTALL_Windows_Short_NET.TXT
parenta19e108db8f1083ab6b6f72975a49cfd2127deba (diff)
downloadhdf5-db3943af6a9473c8a3f5e78018df53b8019e872a.zip
hdf5-db3943af6a9473c8a3f5e78018df53b8019e872a.tar.gz
hdf5-db3943af6a9473c8a3f5e78018df53b8019e872a.tar.bz2
[svn-r13931] Purpose: Update Windows documentation
Description: This makes major updates to the Windows installation documentation, to account for the switch from VS6 to .NET. Installation instructions for 6.0 can also be found in INSTALL_Windows_Short_MSVS6.0.TXT, although it's noted that we are phasing out our VS6 support. Also added install instrctions for MinGW, to reflect our initial support. Updated MANIFEST for new file checkin. Tested: Instructions for each configuration have been tested.
Diffstat (limited to 'release_docs/INSTALL_Windows_Short_NET.TXT')
-rwxr-xr-xrelease_docs/INSTALL_Windows_Short_NET.TXT193
1 files changed, 71 insertions, 122 deletions
diff --git a/release_docs/INSTALL_Windows_Short_NET.TXT b/release_docs/INSTALL_Windows_Short_NET.TXT
index ee408a0..bf56406 100755
--- a/release_docs/INSTALL_Windows_Short_NET.TXT
+++ b/release_docs/INSTALL_Windows_Short_NET.TXT
@@ -91,132 +91,83 @@ notes in INSTALL_Windows.txt before starting below procedures.
Building HDF5 C/C++ Libraries with VS .NET
========================================================================
-1. Run copy_hdf.bat
+ 1. Run batch file copy_hdf.bat
- Go to directory hdf5/windows/, run the batch file copy_hdf.bat to
- copy the nessary files to the directory where they will be used.
+ Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process will
+ copy all the necessary batch files, windows specific source codes and
+ text files saved under c:\MyHDFstuff\hdf5\windows directory to the
+ corresponding directories under hdf5.
-2. Open all.dsw workspace
+ 2. Invoke Microsoft Visual Studio compiler
- In the pop up window, choose "Yes To All" to convert all project
- files to Visual C++ .Net project format.
-
- Notes: all.sln is for command use only. Please open all.dsw
- not all.sln.
-
- Invoke Microsoft Visual C++ .Net 2003. From the main
- menu, go to "File" and select "Open Solution". In
- the "Open Solution" window, Change "Files of type" to
- "All Project Files". Choose "all.dsw" under the directory
- c:\MyHDFstuff\hdf5\windows\proj\all. In the pop up window,
- choose "Yes To All" to convert all project files to Visual
- C++ .Net project format.
-
-3. Disable Fortran project files
-
- Assumption: If there is no intel fortran compiler integrated with
- VS .Net 2003, you need to disable all of the fortran
- project files.
-
- If you want to use intel fortran compiler to build
- HDF5 fortran project files, please read the instruction
- INSTALL_Windows.txt or INSTALL_Windows_Short_Intel.txt.
-
- Go to "Build" and select "Configuration Manager". Choose "Release"
- or "Debug" under "Active Solution Configuration"
-
- Disable the following projects:
-
- flush1_fortran
- flush1_fortrandll
- flush2_fortran
- flush2_fortrandll
- hdf5_f90cstub
- hdf5_f90cstubdll
- hdf5_fortran
- hdf5_fortrandll
- libtest_cstubdll
- libtest_fortran
- libtest_fortrandll
- testhdf5_fortran
- testhdf5_fortrandll
- hdf5_hl_fortran
- hdf5_hl_fortrandll
- hdf5_hl_f90cstubdll
- hl_test_image_fortran
- hl_test_image_fortrandll
- hl_test_lite_fortran
- hl_test_lite_fortrandll
- hl_test_table_fortran
- hl_test_table_fortrandll
-
-4. Building HDF5 C and C++ Libraries
-
- Users can choose the desirable libraries to be built according
- to the following describtion.
-
- 4.1 If you don't want to build HDF5 C++ Libraries,
-
- Go to "Build" and select "Configuration Manager". Choose "Release"
- or "Debug" under "Active Solution Configuration"
-
- Disable the following projects:
-
- dsets_cpp
- dsets_cppdll
- hdf5_cpp
- hdf5_cppdll
- testhdf5_cpp
- testhdf5_cppdll
- hdf5_hl_cpp
- hdf5_hl_cppdll
- hl_test_table_cpp
- hl_test_table_cppdll
-
- Click on "OK", From the main menu, choose "Build"-> "Build" or
- "Rebuild ALL" to build both release and debug version of HDF5
- Libraries.
-
- 4.2 If you don't want to build HDF5 High-Level Libraries,
-
- Go to "Build" and select "Configuration Manager". Choose "Release"
- or "Debug" under "Active Solution Configuration"
-
- Disable the following projects:
-
- hdf5_hl
- hdf5_hldll
- hl_test_image
- hl_test_imagedll
- hl_test_lite
- hl_test_litedll
- hl_test_table
- hl_test_tabledll
- hl_test_ds
- hl_test_dsdll
- hl_test_packet
- hl_test_packetdll
-
- Click on "OK", From the main menu, choose "Build"-> "Build" or
- "Rebuild ALL" to build both release and debug version of HDF5
- Libraries.
-
- 4.3 If you don't want to build HDF5 C++ High-Level C++ Libraries,
+ Invoke Microsoft Visual Studio. From the main menu, go to "File" and
+ select the "Open Solution" option. Then open the
+ c:\MyHDFstuff\hdf5\windows\proj\all\all.sln solution if you are building
+ without Fortran libraries, or
+ c:\MyHDFstuff\hdf5\windows\proj\all_fortran\all_fortran.sln if you would
+ like to use Fortran.
+
+ You should find Windows project files listed as "all", "big", etc. on the
+ left.
+
+
+ 3. (Optional) Disable HDF5 C++ and High level C++
- Go to "Build" and select "Configuration Manager".
- Choose "Release" or "Debug" under "Active Solution Configuration"
-
- Disable the following projects:
-
- hdf5_hl_cpp
- hdf5_hl_cppdll
- hl_test_table_cpp
- hl_test_table_cppdll
+ In HDF5 1.8, C++ and HL C++ libraries are built by default. To opt-out,
+ you must explicitly disable them.
+
+ 3.1 Skip this step if you do want to build HDF5 High-Level C++ libraries
+
+ Go to "Project" and select "Project Dependencies". Select "all", and
+ disable all of the following projects:
+
+ hdf5_hl_cpp
+ hdf5_hl_cppdll
+ hl_test_table_cpp
+ hl_test_table_cppdll
+
+ 3.2 Skip this step if you do want to build HDF5 High-Level libraries
+
+ Go to "Project" and select "Project Dependencies". Select "all", and
+ disable all of the project files listed in the previous step, as well
+ as the following projects:
+
+ hdf5_hl
+ hdf5_hldll
+ hl_test_image
+ hl_test_imagedll
+ hl_test_lite
+ hl_test_litedll
+ hl_test_table
+ hl_test_tabledll
+ hl_test_ds
+ hl_test_dsdll
+ hl_test_packet
+ hl_test_packetdll
Click on "OK", From the main menu, choose "Build"-> "Build" or
"Rebuild ALL" to build both release and debug version of HDF5
Libraries.
-
+
+
+ 4. Select "Build", then Select "Configuration Manager".
+
+ 4.1 To build debug static libraries, debug multithreaded DLLs, and tests:
+
+ In "Active Solution Configuration", select "Debug". Select "Close".
+ Select "Build" -> "Build Solution" or "Rebuild Solution" to build debug
+ version of project "all".
+
+ 4.2 To build release static libraries, multithreaded DLLs and tests:
+
+ In "Active Solution Configuration", select "Release". Select "Close".
+ Select "Build" -> "Build Solution" or "Rebuild Solution" to build release
+ version of project "all".
+
+ Both debug and release versions must be built.
+
+ Warning messages can be ignored.
+
========================================================================
Testing HDF5 C/C++ Libraries with VS .NET
========================================================================
@@ -231,11 +182,9 @@ hdf5check.bat has four options:
hdf5check enablecpp test HDF5 C/C++ libraries and tools
- hdf5check enablefortran test HDF5 C/Fortran libraries
- and tools
+ hdf5check enablefortran test HDF5 C/Fortran libraries and tools
- hdf5check enableall test HDF5 C/C++/Fortran libraries
- and tools
+ hdf5check enableall test HDF5 C/C++/Fortran libraries and tools
Notes: Users who only build HDF5 C/C++ libraries ONLY have the first