summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_Windows_withcpp.txt
diff options
context:
space:
mode:
authorBinh-Minh Ribler <bmribler@hdfgroup.org>2002-02-26 15:02:32 (GMT)
committerBinh-Minh Ribler <bmribler@hdfgroup.org>2002-02-26 15:02:32 (GMT)
commit29581b5137c5525b746ca4835cc076f43a25e6ab (patch)
tree182b9571f5feaf3c0779b42181f3a91c1630cd83 /release_docs/INSTALL_Windows_withcpp.txt
parentc78139de47ec5b20210070626764849dfd42de8e (diff)
downloadhdf5-29581b5137c5525b746ca4835cc076f43a25e6ab.zip
hdf5-29581b5137c5525b746ca4835cc076f43a25e6ab.tar.gz
hdf5-29581b5137c5525b746ca4835cc076f43a25e6ab.tar.bz2
[svn-r5012] Purpose:
Windows support Description: Added the install file to 1.5 specifically for C++ API on Windows.
Diffstat (limited to 'release_docs/INSTALL_Windows_withcpp.txt')
-rw-r--r--release_docs/INSTALL_Windows_withcpp.txt116
1 files changed, 116 insertions, 0 deletions
diff --git a/release_docs/INSTALL_Windows_withcpp.txt b/release_docs/INSTALL_Windows_withcpp.txt
new file mode 100644
index 0000000..62821d9
--- /dev/null
+++ b/release_docs/INSTALL_Windows_withcpp.txt
@@ -0,0 +1,116 @@
+===============================================================================
+ HDF5 C++ Library Build and Testing Instructions for Windows NT/98
+ with Microsoft Visual C++ V 6.0
+===============================================================================
+
+ This is applicable to the development version of HDF5 libraries.
+
+Preconditions
+-------------
+
+ 1. These instructions are for users who wish to build the C and
+ C++ libraries. If you are interested only in the C library,
+ refer to INSTAll_Windows.txt or INSTAll_codewarrior.txt.
+
+ 2. MicroSoft Developer Studio,Visual C++ 6.0 and WinZip must be
+ installed prior to building the HDF5 library.
+
+ 3. Set up a directory structure to unpack the library.
+ For example:
+
+ c:\ (any drive of your choice)
+ MyHDFstuff\ (any folder name)
+
+ 4. Download the hdf5xxx distribution archive and use WinZip to
+ extract the hdf5 package into c:\MyHDFstuff. This creates a
+ directory called 'hdf5xxx' under MyHDFstuff which contains
+ several files and directories. Rename "hdf5xxx" to "hdf5".
+
+ 5. HDF5 uses the zlib library, which is distributed with the HDF5
+ Windows source code.
+
+
+Building the HDF5 C and C++ libraries (both static and shared)
+-------------------------------------
+
+ 1. Unpack all.zip, found in the c:\MyHDFstuff\hdf5\windows directory,
+ into c:\MyHDFstuff.
+
+ 2. Go to the hdf5\proj\ directory and double-click on the file all.dsw.
+ This will invoke MS VC++.
+
+ 3. Make sure that "all" is "Set as Active Project" by selecting
+ "Project"/"Set Active Project", or right-clicking on "all" then
+ selecting "Set as Active Project."
+
+ 4. Select "Project"/"Dependencies", then enable the desired projects:
+
+ hdf5_cpp: to build the C++ API static library
+ dsets_cpp: to build the test dsets.cpp, must also select hdf5_cpp
+ testhdf5_cpp: to build the test testhdf5.cpp, must also select hdf5_cpp
+
+ hdf5_cppdll: to build the C++ API dynamic-linked library
+ dsets_cppdll: to build the DLL dsets test, must also select hdf5_cppdll
+ testhdf5_cppdll: to build the DLL testhdf5 test, must also select
+ hdf5_cppdll
+
+ 5. Select "Build", then select "Set Active Configuration".
+
+ "all -- Win32 Debug" to build debug versions of
+ single-threaded static libraries, debug multithreaded DLLs,
+ and tests.
+
+ "all -- Win32 Release" to build release versions of
+ single-threaded static libraries, multithreaded DLLs,
+ and tests.
+
+ NOTE: "all" is a dummy target, "all.exe" is never created.
+
+ When the debug or release build is completed, the directories
+ listed below will contain the following files:
+
+ hdf5\proj\hdf5\debug -
+ hdf5\proj\hdf5\release -
+ hdf5.lib- the C hdf5 static library
+
+ hdf5\proj\hdf5dll\debug -
+ hdf5ddll.dll- the C hdf5 library
+ hdf5ddll.lib- the dll export library
+
+ hdf5\proj\hdf5dll\release -
+ hdf5dll.dll- the C hdf5 library
+ hdf5dll.lib- the dll export library
+
+ hdf5\proj\hdf5_cpp\debug -
+ hdf5\proj\hdf5_cpp\release -
+ hdf5_cpp.lib- the hdf5 C++ API static library
+
+ hdf5\proj\hdf5_cppdll\debug -
+ hdf5_cppddll.dll- the hdf5 C++ API dll library
+ hdf5_cppddll.lib- the C++ API dll export library
+ hdf5\proj\hdf5_cppdll\release -
+ hdf5_cppdll.dll- the hdf5 C++ API dll library
+ hdf5_cppdll.lib- the C++ API dll export library
+
+
+Testing libraries and tools
+---------------------------
+
+ 1. See the file INSTALL_Windows.txt (STEP 2) for instruction on
+ testing the C HDF5 library and non-hdf4-related tools.
+
+ 2. To test C++ HDF5 Library, you first need to copy the appropriate
+ DLL files to the Windows system directory.
+
+ The system directory can usually be found under the path
+ C:\WINNT\system or C:\WINDOWS\system
+
+ You can now run hdf5cpptest.bat in the hdf5\c++\test directory
+ at the command prompt as below:
+
+ hdf5cpptest release
+ hdf5cpptest release dll
+ hdf5cpptest debug
+ hdf5cpptest debug dll
+
+Please send mail to hdfhelp@ncsa.uiuc.edu for further assistance.