[svn-r1655] added some lines in the test section about the dumptest batch files

1 files changed, 60 insertions, 9 deletions

diff --git a/INSTALL_Windows.txt b/INSTALL_Windows.txt
index d69971c..2390c53 100644
--- a/INSTALL_Windows.txt
+++ b/INSTALL_Windows.txt
@@ -34,16 +34,23 @@ To build the HDF5 and tests, it is assumed that you have done the following:
 
 
 STEP II: Building the Libraries and tests.
+        1. Rename the directory under C:\myHDFstuff\ from hdf5xxx to hdf5.  
 
-        1. Unpack all.zip in 'hdf5' and move the zlib.dll from 
+        2. Unpack all.zip in 'hdf5' and move the zlib.dll from 
 	     c:\myHDFstuff\hdf5\src\dll to the Windows system directory.
 
-        2. Invoke Microsoft Visual C++, go to "File" and select
+           NOTE TO ALPHA USERS- the version of zlib that is packaged in all.zip 
+           is for Intel platforms.  The Alpha versions of the libraries can be
+           obtained from ftp://hdf.ncsa.uiuc.edu/HDF5/.  The file to download
+           is Alphazlib.zip.  After the file is downloaded replace the src\zlib
+           directory with the files from Alphazlib.zip.
+
+        3. Invoke Microsoft Visual C++, go to "File" and select
            the "Open Workspace" option. 
 
            Then open the c:\myHDFstuff\hdf5\proj\all\all.dsw workspace. 
 
-        3. Select "Build", then Select "Set Active Configuration".
+        4. Select "Build", then Select "Set Active Configuration".
 
            On Windows platform select as the active configuration
 
@@ -54,6 +61,15 @@ STEP II: Building the Libraries and tests.
            "all -- Win32 Release" to build release versions of single-threaded
                                 static libraries, and tests.
 
+           On the Alpha platform select as the active configuration
+
+           "all -- Win32 AlphaDbg" to build debug versions of single-threaded
+                                static libraries, and tests. 
+            or
+
+           "all -- Win32 AlphaRel" to build release versions of single-threaded
+                                static libraries, and tests.
+
            Select "Build" and "Build all.exe" to
            build the corresponding version of the HDF5 library.
 
@@ -74,6 +90,12 @@ STEP II: Building the Libraries and tests.
 
 			hdf5.lib- the hdf5 library
 
+            c:\MyHDFstuff\hdf5\proj\hdf5dll\debug - 
+            c:\MyHDFstuff\hdf5\proj\hdf5dll\release - 
+
+			hdf5.dll- the hdf5 library
+                  hdf5.lib- the dll export library
+
            	c:\MyHDFstuff\hdf5\test\"test directory"-
             where test directory is one of the following:
 
@@ -89,6 +111,8 @@ STEP II: Building the Libraries and tests.
 			dsets
 
 			dtypes
+			
+			enum
 
 			extend
 
@@ -110,15 +134,17 @@ STEP II: Building the Libraries and tests.
 
 			links
 
-			mount (not supported in this release)
+			mount 
 
 			mtime
 
+			ohdr
+
 			overhead
 
 			ragged 
 
-			shtype 
+			stab
 
 			testhdf5 
 
@@ -133,19 +159,36 @@ STEP III:   TESTING THE BUILD
 
 
 In a command prompt window run the test batch file which 
-resides in the hdf5 directory to make sure that the library
+resides in the hdf5\test directory to make sure that the library
 was built correctly.
 
 The hdf5testDBG.bat file tests the debug version of the library and 
 hdf5testREL.bat tests the release version of the library.
- 
+
+The hdf5testdllDBG.bat file tests the debug version of the dll and 
+hdf5testdllREL.bat tests the release version of the dll.  The debug dll or
+the release dll should be placed in the Windows\system directory before the dll
+tests are run.  Both the release and the debug dlls have the same name so 
+only one may be used at a time.
+
+In the hdf5\tools directory, there are 4 batch files that can be used to test
+h5dump.  The file dumptestDBG.bat tests the debug version of the dump utility
+and the dumptestREL.bat tests the release version.  The dumptestDLLDBG.bat
+tests the debug dll version of the dumper and the dumptestDLLREL.bat tests
+the release dll version.  Some differences are expected in the output of these
+4 tests (dimensions of the dataspace).
+
+
+
+NOTE: The debug dll tests on the Alpha platform currently are not completely
+      working.  The release dll is fine though.
 
         
 STEP IV: BUILDING THE EXAMPLES
 
      1. Invoke Microsoft Visual C++, go to "File" and select
         the "Open Workspace" option. 
-        Then open the c:\myHDFstuff\hdf5\examples\allexamples.dsw
+        Then open the c:\myHDFstuff\hdf5\examples\allexamples\allexamples.dsw
         workspace. 
 
       2. Select "Build", then Select "Set Active Configuration".
@@ -157,6 +200,14 @@ STEP IV: BUILDING THE EXAMPLES
 	
            "allexamples -- Win32 Release" to build release versions the            		examples.
 
+         On Alpha platform select as the active configuration
+           "allexamples -- Win32 AlphaDbg" to build debug versions of the         					examples. 
+            
+		or
+	
+           "allexamples -- Win32 AlphaRel" to build release versions the           
+                              examples.
+
            Select "Build" and "Build allexamples.exe" to
            build the corresponding version of the examples.
 
@@ -183,7 +234,7 @@ STEP IV: BUILDING THE EXAMPLES
 
 	3. Run the batch file "InstallExamples.bat" which resides in the top
  	   level directory.  This file creates 2 new directories, examplesREL and
-	   examplesDEB, in the examples directory and places all the executables 
+	   examplesDBG, in the 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.  The examples should be tested in these
 	   2 new directories due to some dependencies between the examples.