summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFang Guo <fangguo@ncsa.uiuc.edu>2005-06-10 19:09:26 (GMT)
committerFang Guo <fangguo@ncsa.uiuc.edu>2005-06-10 19:09:26 (GMT)
commitae41553de2f8dcafd94dc7fff1c0755898af229e (patch)
tree67a05c61eff5d964c6cab3059f5d25b655b376e8
parent072c08b7aff54268a2871780070ab34052ed8201 (diff)
downloadhdf5-ae41553de2f8dcafd94dc7fff1c0755898af229e.zip
hdf5-ae41553de2f8dcafd94dc7fff1c0755898af229e.tar.gz
hdf5-ae41553de2f8dcafd94dc7fff1c0755898af229e.tar.bz2
[svn-r10893] Purpose:
Add short version instruction for Visual C++ .net 2003 Description: Short version instruction for building and testing HDF5 with Visual C++ .Net was added. Solution: Platforms tested: Misc. update:
-rwxr-xr-xrelease_docs/INSTALL_Windows_Short_NET.TXT212
1 files changed, 212 insertions, 0 deletions
diff --git a/release_docs/INSTALL_Windows_Short_NET.TXT b/release_docs/INSTALL_Windows_Short_NET.TXT
new file mode 100755
index 0000000..359cf4f
--- /dev/null
+++ b/release_docs/INSTALL_Windows_Short_NET.TXT
@@ -0,0 +1,212 @@
+HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003
+ (Short Version)
+------------------------------------------------------------------------
+Note: This short instruction is written for users who want to quickly
+ build HDF5 library and tools from the HDF5 source code package
+ with Microsoft Visual Studio .NET 2003 but do not want to know HDF5
+ building and installation details on Windows XP.
+
+ For detailed HDF5 build and install information, or if you have
+ trouble following any steps in the instructions, please refer to
+ INSTALL_Windows.txt for further information.
+
+ For users who would like to build and test HDF5 package from the
+ command line, please refer to
+ INSATLL_Windows_From_Command_Line.txt.
+
+***************************WARNINGS*************************************
+Please read CAREFULLY about HDF5 build and install preconditions and
+notes in INSTALL_Windows.txt before starting below procedures.
+************************************************************************
+
+Preconditions:
+
+ a. Setup Szip Library for Visual Studio .Net 2003 Compiler.
+
+ Szip source codes or binaries can be downloaded
+ from the following address:
+
+ ftp://ftp.ncsa.uiuc.edu/HDF/szip/bin/windows.
+
+ b. Set up path for external libraries and headers
+
+ Skip this part if you don't want to use ANY compression features
+ provided by HDF5. Please do read section V.
+
+ You have to read this part even if you want to only use Zlib
+ or Szip. You also need to read section V.
+
+ Invoke Microsoft Visual C++ .Net and go to "Tools" and select
+ "Options". In the left pane of "Option" window poped up,
+ choose and extend "Projects", Click on "VC++ Directories".
+ In the right pane, Find the box "Show directories for", choose
+ "Include files", if you can not find your Zlib and Szip
+ header path
+ (for example, c:\zlib122\include, c:\szip\include)
+ from the directory list, add the header path
+ (c:\zlib122\include, c:\szip\include) to the
+ included directories.
+
+ Find the box "Show directories for", choose "Library files",
+ If you cannot find your Zlib and Szip library path
+ (for example, c:\zlib122\lib, c:\szip\dll)
+ from the directory list, add the library path
+ (c:\zlib122\lib, c:\szip\dll) to the library directories.
+
+1. Open all.dsw workspace
+
+ 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,
+ chooise "Yes To All" to convert all project files to Visual
+ C++ .Net project format.
+
+2. Building HDF5 C and C++ Libraries
+
+ Users can choose the desirable libraries to be built according
+ to the following describtion.
+
+ 2.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
+ hl_test_table_cpp
+
+ Click on "OK", From the main menu, choose "Build"-> "Build" or
+ "Rebuild ALL" to build both release and debug version of HDF5
+ Libraries.
+
+ 2.2 If you don't want to build HDF5 Fortran Libraries,
+ 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
+ hl_test_image_fortran
+ hl_test_lite_fortran
+ hl_test_table_fortran
+
+ Click on "OK", From the main menu, choose "Build"-> "Build" or
+ "Rebuild ALL" to build both release and debug version of HDF5
+ Libraries.
+
+ 2.3 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
+ hl_test_image
+ hl_test_lite
+ hl_test_table
+ hl_test_ds
+ hl_test_packet
+
+ Click on "OK", From the main menu, choose "Build"-> "Build" or
+ "Rebuild ALL" to build both release and debug version of HDF5
+ Libraries.
+
+ 2.4 If you don't want to build HDF5 C++ High-Level C++ Libraries,
+ Go to "Build" and select "Configuration Manager".
+ Choose "Release" or "Debug" under "Active Solution Configuration"
+
+ Disable the following projects:
+
+ hdf5_hl_cpp
+ hl_test_table_cpp
+
+ Click on "OK", From the main menu, choose "Build"-> "Build" or
+ "Rebuild ALL" to build both release and debug version of HDF5
+ Libraries.
+
+ 2.5 If you don't want to build HDF5 Fortran High-Level Libraries,
+ Go to "Build" and select "Configuration Manager".
+ Choose "Release" or "Debug" under "Active Solution Configuration".
+
+ Disable the following projects:
+
+ hdf5_hl_fortran
+ hl_test_image_fortran
+ hl_test_lite_fortran
+ hl_test_table_fortran
+
+ Click on "OK", From the main menu, choose "Build"-> "Build" or
+ "Rebuild ALL" to build both release and debug version of HDF5
+ Libraries.
+
+3. Testing HDF5 Libraries and Tools.
+
+HDF5 libraries and tools should be tested to make sure that they were
+built correctly.
+
+HDF5 libraries and tools can be tested with hdf5check.bat batch file
+in c:\MyHDFstuff\hdf5 directory.
+
+hdf5check.bat has four options:
+
+ hdf5check test HDF5 C library and tools only
+
+ hdf5check enablecpp test HDF5 C/C++ libraries and tools
+
+ hdf5check enablefortran test HDF5 C/Fortran libraries
+ and tools
+
+ hdf5check enableall test HDF5 C/C++/Fortran libraries
+ and tools
+
+
+Invoke a command prompt window and run hdf5check with appropriate
+options.
+
+Test results are saved in two files:
+
+ c:\MyHDFstuff\hdf5\tests_results.txt
+
+ c:\MyHDFstuff\hdf5\check_results.txt.
+
+In general, you only need to check tests_results.txt. If all the
+tests passed, then you do not have to check check_results.txt.
+If some tests failed, check check_results.txt can help you
+figure out what was wrong.
+
+If you want to test HDF5 libraries and tools one by one, please refer to
+section II, step 2 in INSTALL_Windows.txt.
+
+
+STEP 3: Installing HDF5 Libraries
+
+Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install
+all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory.
+
+
+STEP 4: Building HDF5 Examples (Optional)
+
+Please read section II, step 4 in INSTALL_Windows.txt.
+
+