From ffc727c3de1fb75c056a2fb3c1f16562c2236ad3 Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Tue, 20 Dec 2005 15:22:45 -0500 Subject: [svn-r11802] Purpose: Maintenance on Windows Description: Add in instruction for building hl fortran examples Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows.txt | 97 ++++++++++++++++++++++++++++++++++------ 1 file changed, 84 insertions(+), 13 deletions(-) diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index 5826226..98ad2d0 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -227,7 +227,7 @@ Notes: 3. Examples (Not included in the binary distribution) HDF5 examples: - simple HDF5 C/C++/Fortran and High level C examples + simple HDF5 C/C++/Fortran and High level C/Fortran examples ======================================================================== Section II: How to build and test HDF5 libraries and tools @@ -893,10 +893,10 @@ The layout of should be: You may also find the similar layout for the . -STEP 4: Building HDF5 C/C++/Fortran and High Level C examples (Optional) +STEP 4: Building HDF5 C/C++/Fortran & HL C/Fortran examples (Optional) Simple examples have been provided for users to test HDF5 -C/C++/Fortran and high level c library and tools. +C/C++/Fortran and high level C/Fortran library and tools. Note: 1) To build HDF5 C++ examples, HDF5 C++ library must have been @@ -916,7 +916,7 @@ Note: HDF5 C/C++/Fortran libraries and DLLs. To build and test HDF5 C examples: - +---------------------------------- 1. Invoke Microsoft Visual C++, go to "File" and select the "Open Workspace" option. @@ -985,6 +985,7 @@ To build and test HDF5 C examples: will be given. To build and test HDF5 C++ examples: +------------------------------------ 1. Invoke Microsoft Visual C++ 6.0, choose "File" and select the "Open Workspace" option. @@ -1054,6 +1055,7 @@ To build and test HDF5 C++ examples: will be given. To build and test HDF5 Fortran example: +--------------------------------------- 1. Invoke Compaq Visual Fortran or intel Fortran under Microsoft Visual studio development environment, go to "File" and select @@ -1117,30 +1119,33 @@ To build and test HDF5 Fortran example: versions of the examples should be built before this step is done. To build and test HDF5 High Level C examples: +--------------------------------------------- 1. Invoke Microsoft Visual C++, go to "File" and select the "Open Workspace" option. - Then open the workspace - c:\MyHDFstuff\hdf5\windows\hl\hl_c_examples\hl_c_examples.dsw. + Then open the workspace + +c:\MyHDFstuff\hdf5\windows\hl\examples\allhlcexamples\allhlcexamples.dsw 2. Select "Build", then Select "Set Active Configuration". 2.1 To build debug versions of High Level C examples. In "Project configurations", select - "hl_c_examples -- Win32 Debug", select "ok". Select + "allhlcexamples -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to build debug version - of project "hl_c_examples". + of project "allhlcexamples". 2.2 To build release versions of C examples. In "Project configurations", select - "hl_c_examples -- Win32 Release", select "ok". Select + "allhlcexamples -- Win32 Release", select "ok". Select "Build" -> "Build" or "Rebuild All" to build release version - of project "hl_c_examples". + of project "allhlcexamples". When the debug build or release build is done, there should be the - following subdirectories in c:\MyHDFstuff\hdf5\hl\hl_c_examples + following subdirectories in c:\MyHDFstuff\hdf5\hl\examples + allhlcexamples ex_images ex_imagesdll ex_lite @@ -1152,13 +1157,13 @@ To build and test HDF5 High Level C examples: Install_hlcexamples.bat which resides in the top level directory (c:\MyHDFstuff\hdf5). This file creates 4 new directories, HLCexamplesRELEASE, HLCexamplesRELEASEDLL, HLCexamplesDEBUG, and - HLCexamplesDEBUGDLL, in the c:\MyHDFstuff\hdf5\hl\hl_c_examples + HLCexamplesDEBUGDLL, in the c:\MyHDFstuff\hdf5\hl\examples directory and places all the executables in it. Both the release and debug versions of the examples should be built before this step is done. 4. We provide a batch file named test_hl_cexamples.bat in - c:\MyHDFstuff\hdf5\hl\hl_c_examples directory for you to test + c:\MyHDFstuff\hdf5\hl\examples directory for you to test HDF5 high level C examples. test_hl_cexamples.bat batch file has 4 options: @@ -1188,6 +1193,72 @@ To build and test HDF5 High Level C examples: Similar messages should be generated with another three options If the high level C examples are built successfully. +To build and test HDF5 High Level Fortran examples: +--------------------------------------------------- + + 1. Invoke Compaq Visual Fortran 6.6c, open the workspace + + c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\ (continue next line) + allhlf90examples\allhlf90examples.dsw + + 2. Select "Build", then Select "Set Active Configuration". + + 2.1 To build debug versions of High Level Fortran examples. + In "Project configurations", select + "allhlf90examples -- Win32 Debug", select "ok". Select + "Build" -> "Build" or "Rebuild All" to build debug version + of project "allhlf90examples". + + 2.2 To build release versions of Fortran examples. + In "Project configurations", select + "allhlf90examples -- Win32 Release", select "ok". Select + "Build" -> "Build" or "Rebuild All" to build release version + of project "allhlf90examples". + + When the debug build or release build is done, there should be the + following subdirectories in c:\MyHDFstuff\hdf5\hl\fortran\examples + + ex_lite + ex_litedll + +3. Invoke a command prompt window and run the batch file + Install_hlf90examples.bat which resides in the top level directory + (c:\MyHDFstuff\hdf5). This file creates 4 new directories, + HLf90examplesRELEASE, HLf90examplesRELEASEDLL, HLf90examplesDEBUG, + and HLf90examplesDEBUGDLL, in the + c:\MyHDFstuff\hdf5\hl\fortran\examples directory and places all + the executables in it. Both the release + and debug versions of the examples should be built before this + step is done. + + 4. We provide a batch file named test_hl_f90examples.bat in + c:\MyHDFstuff\hdf5\hl\fortran\examples directory for you to test + HDF5 high level fortran examples. + + test_hl_f90examples.bat batch file has 4 options: + + Options purpose + + test_hl_f90examples release -- for release version + + test_hl_f90examples release dll -- for release DLL version + + test_hl_f90examples debug -- for debug version + + test_hl_f90examples debug dll -- for debug DLL version + + Invoke a command prompt window and run test_hl_f90examples with + appropriate options. + + When you run "test_hl_f90examples release", the output will look + like: + + release version of High Level Fortran examples PASSED + + Similar messages should be generated with another three options + If the high level Fortran examples are built successfully. + + ======================================================================== Section III: Building an application using the HDF5 library or DLL ======================================================================== -- cgit v0.12