[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:

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.
+
+