[svn-r9503] Purpose:

Update windows installation document on 1.7 branch.

Description:

Solution:

Platforms tested:

Misc. update:

1 files changed, 193 insertions, 0 deletions

diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt
new file mode 100755
index 0000000..e7b0960
--- /dev/null
+++ b/release_docs/INSTALL_Windows_From_Command_Line.txt
@@ -0,0 +1,193 @@
+      Instructions for Building and Testing HDF5 on Command Line
+                         for Windows XP/2000
+
+************************************************************************
+Note: This instruction is written for users who would like to build HDF5
+      libraries and tools from the HDF5 source code package on command
+      line.
+         
+      Currently, we only support building and testing HDF5 on command
+      line with Microsoft Visual C++ 6.0 and DEC Fortran 6.0.
+      
+      For all other Windows development tools, HDF5 should be built in
+      the development environment.  Please refer to INSTALL_Windows.txt
+      for detailed HDF5 building and installation information, or 
+      INSTALL_Windows_short.txt for quick HDF5 building and installation
+      instructions.
+            
+*****************************WARNINGS***********************************
+
+Please read CAREFULLY about HDF5 build and install preconditions and 
+notes in INSTALL_Windows.txt before starting below procedures.
+
+************************************************************************
+
+Extra Preconditions
+
+   1. Set path for Microsoft Visual C++ 6.0 and DEC Fortran 6.0
+   
+      Open "System" in Control Panel.
+   
+      On the "Advanced" tab, click "Environment Variables", click 
+      "Path" in the "System variables" box, then click "Edit" and 
+      add your Visual C++ 6.0 path (For example, 
+      C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\)
+      and DEC Fortran 6.0 path (For example, 
+      C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\)
+      into "Variable Value" and click "OK".
+
+   2. Add WinZip command line support (Optional)
+      
+      To use WinZip command line utility, you have to install 
+      WinZip 9.0 or higher version.
+
+      If you want to extract hdf5\windows\all.zip on the command line,
+      you should
+   
+      2.1 Install WinZip command line support add-on 1.1
+   
+          Download WinZip command line support add-on 1.1 from 
+          http://www.winzip.com and install it.
+   
+      2.2 Add WinZip into environment path
+   
+          Open "System" in Control Panel.
+          On the "Advanced" tab, click "Environment Variables", click
+          "Path" in the "System variables" box, then click "Edit" and 
+          add your WinZip path (For example C:\Program Files\WinZip)
+          into "Variable Value" and click "OK".
+
+      Note: 
+         You can also extract all.zip from interactive WinZip interface 
+         without the above two steps.
+  
+***********************************************************************
+Step 1. Building and testing HDF5 libraries and tools
+
+   1. Unpack all.zip
+
+      Unpack all.zip in c:\MyHDFstuff\hdf5\windows into the 
+      C:\myHDFstuff directory.
+      
+      This can be done with either of the following 2 options:
+
+      Option A. Unpack from the interactive WinZip interface
+
+      Option B. unpack on the command line
+
+         cd into the c:\MyHDFstuff\hdf5\windows directory
+   
+         type: wzunzip -yO -d -o all.zip c:\MyHDFstuff
+   
+
+   2. Build and Test
+
+      We provide 2 options for users to build test HDF5 libraries 
+      and tools.
+      
+      Options A: Build and test in one step 
+      
+         A batch file named hdf5bt.bat in c:\MyHDFstuff\hdf5 directory
+         is provided for users to build and test HDF5 library and tools
+         together from command line.
+
+         hdf5bt.bat has four options:
+
+            hdf5bt                 build and test C library and tools
+
+            hdf5bt enablecpp       build and test C/C++ libraries 
+                                   and tools
+
+            hdf5bt enablefortran   build and test C/Fortran libraries
+                                   and tools
+
+            hdf5bt enableall       build and test C/C++/Fortran 
+                                   libraries and tools
+
+         Invoke a command prompt window and run hdf5bt with
+         appropriate options.
+
+         Test results are saved in two files:
+
+            c:\MyHDFstuff\hdf5\hdf5_results.txt   
+
+            c:\MyHDFstuff\hdf5\tests_results.txt.
+
+         In general, you only need to check tests_results.txt.
+         If all the tests passed, then you do not have to check
+         hdf5_results.txt.  If some tests failed, check
+         hdf5_results.txt can help you figure out what was wrong.
+
+      Options B: Build and test in two steps 
+
+         We also provide users with the option to build and test 
+         HDF5 libraries and tools seperately.
+   
+         Step 1) Build HDF5 Libraries and Tools
+
+            A batch file named hdf5build.bat in c:\MyHDFstuff\hdf5 
+            directory is provided for users to build HDF5 library and 
+            tools from command line.
+
+            hdf5build.bat has four options:
+  
+               hdf5build                 build HDF5 C library 
+                                         and tools
+
+               hdf5build enablecpp       build HDF5 C/C++ libraries 
+                                         and tools
+
+               hdf5build enablefortran   build HDF5 C/Fortran libraries
+                                         and tools
+
+               hdf5build enableall       build HDF5 C/C++/Fortran 
+                                         libraries and tools
+
+            Invoke a command prompt window and run hdf5build with 
+            appropriate options.  Compiling outputs are saved in 
+            c:\MyHDFstuff\hdf5\build_results.txt.  You can check 
+            the file to find out whether there are any compilation
+            errors.
+
+         Step 2) Test HDF5 Libraries and Tools
+   
+            A batch file named hdf5check.bat in c:\MyHDFstuff\hdf5
+            directory is provided for users to test HDF5 library 
+            and tools from command line.
+
+            hdf5check.bat has four options:
+
+               hdf5check                 test HDF5 C library and tools
+      
+               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.
+
+
+   
+STEP 2: 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.
+
+
+For further information, please refer to INSTALL_WINDOWS.txt.
\ No newline at end of file