From f2240792704b74fc288b4e4a570509c4afe4a34e Mon Sep 17 00:00:00 2001 From: Fang Guo Date: Mon, 1 Aug 2005 12:00:55 -0500 Subject: [svn-r11178] Purpose: Maintenance on windows Description: Reformat to have a clear look Solution: Platforms tested: Misc. update: --- release_docs/INSTALL_Windows_From_Command_Line.txt | 185 +++++++++++---------- 1 file changed, 93 insertions(+), 92 deletions(-) diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index 712def0..dafe945 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -1,5 +1,6 @@ -Instructions for Building and Testing HDF5 in Command Line on Windows XP - +************************************************************************ +* Instructions for Building and Testing HDF5 on Windows XP * +* (From Command Line) * ************************************************************************ Note: This instruction is written for users who would like to build HDF5 libraries and tools from the HDF5 source code package on command @@ -35,14 +36,14 @@ Note: This instruction is written for users who would like to build HDF5 Be careful to type in the corresponding command when you choose a procedure below to build HDF5 Libraries. -*****************************WARNINGS*********************************** +WARNINGS: Please read CAREFULLY about HDF5 build and install preconditions and notes in INSTALL_Windows.txt before starting below procedures. -************************************************************************ - -Preconditions +======================================================================== + Preconditions +======================================================================== 1. Add WinZip command line support (Optional) @@ -65,17 +66,16 @@ Preconditions add your WinZip path (For example C:\Program Files\WinZip) into "Variable Value" and click "OK". - Note: + Notes: You can also extract zip files from interactive WinZip interface without the above two steps. -*********************************************************************** -Section I: Building and testing HDF5 on command line with Microsoft - Visual C++ 6.0 and Compaq Visual Fortran 6.0. +======================================================================== + Section I: Building and testing HDF5 on command line with Microsoft + Visual C++ 6.0 and Compaq Visual Fortran 6.0. +======================================================================== -*********************************************************************** - 1. Extra Preconditions: 1.1 Set path for Visual C++ 6.0 and Compaq Visual Fortran 6.0 @@ -96,7 +96,7 @@ Section I: Building and testing HDF5 on command line with Microsoft 2. Building and testing HDF5 libraries and tools - We provide 2 options for users to build test HDF5 libraries + We provide 2 options for users to build and test HDF5 libraries and tools. 2.1 Options A: Build and test in one step @@ -170,31 +170,30 @@ Section I: Building and testing HDF5 on command line with Microsoft and tools from command line. hdf5check.bat has four options: + + hdf5check Test HDF5 C Libraries and Tools - 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 + 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. + 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. + 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. 3. Installing HDF5 Libraries @@ -203,12 +202,11 @@ HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory. For further information, please refer to INSTALL_WINDOWS.txt. -************************************************************************ - + +======================================================================== SECTION II: Building and testing HDF5 C and C++ Library on command line with Microsoft Visual C++ .Net 2003 - -*********************************************************************** +======================================================================== 1. Extra Preconditions: @@ -216,20 +214,21 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line 1.2 Command-based script host (CScript.exe) installed - Cscript.exe is a command-line version of the Windows Script Host. Users can - check windows system directory to make sure Cscript.exe installed. Cscript.exe - will be used during converting project files from MSVS 6.0 Format to Visual C++ + Cscript.exe is a command-line version of the Windows Script + Host. Users can check windows system directory to make sure + Cscript.exe installed. Cscript.exe will be used during + converting project files from MSVS 6.0 Format to Visual C++ .Net 2003 format. 1.3 Set path for Microsoft Visual C++ .Net - Open "System" in Control Panel. + 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++ .Net path (For example, - C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\IDE) - into "Variable Value" and click "OK". + On the "Advanced" tab, click "Environment Variables", click + "Path" in the "System variables" box, then click "Edit" and + add your Visual C++ .Net path (For example, + C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\IDE) + into "Variable Value" and click "OK". 1.4 Run batch file copy_hdf.bat. @@ -261,7 +260,7 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line 2. Building HDF5 C and C++ Libraries : - We provide 2 options for users to build HDF5 libraries and tools. + We provide 2 options for users to build and test HDF5 libraries and tools. 2.1 Options A: Build and test in one step @@ -269,12 +268,13 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line is provided for users to build and test HDF5 library and tools together from command line. - Invoke a command prompt window and run hdf5bt_net in the - following format to build and test C/C++ libraries and tools. + Invoke a command prompt window and run hdf5bt_net with one of the + options below to build and test desired library: - hdf5bt_net enablecpp + hdfbt_net Build and Test HDF5 C Library and tools + hdf5bt_net enablecpp Build and Test HDF5 C/C++ Library and tools - Test results are saved in two files: + Test results are saved in two files: c:\MyHDFstuff\hdf5\hdf5_results_net.txt @@ -296,10 +296,11 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line directory is provided for users to build HDF5 library and tools from command line. - Invoke a command prompt window and run hdf5build_net.bat in - the following format to build HDF5 C/C++ library and tools. - - hdf5build_net enablecpp + Invoke a command prompt window and run hdf5build_net.bat with + the following options to build desired HDF5 Library: + + hdf5build_net Build HDF5 C Library and Tools + hdf5build_net enablecpp Build HDF5 C/C++ Library and Tools Building results will be saved in c:\MyHDFstuff\hdf5\build_results_net.txt. You can check @@ -311,36 +312,34 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line Go to directory, run batch file hdf5check with the following options: - hdf5check test HDF5 C library and tools + hdf5check Test HDF5 C Library and Tools - hdf5check enablecpp test HDF5 C/C++ libraries - and tools + hdf5check enablecpp Test HDF5 C/C++ Libraries and Tools - Note: hdf5check.bat has ONLY TWO options listed above in this case. + Note: hdf5check.bat has ONLY TWO options listed above in this case. - Test results are saved in two files: + Test results are saved in two files: - c:\MyHDFstuff\hdf5\tests_results.txt + c:\MyHDFstuff\hdf5\tests_results.txt - c:\MyHDFstuff\hdf5\check_results.txt. + c:\MyHDFstuff\hdf5\check_results.txt. - In general, you only need to check tests_results.txt. If all the + 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. 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. + Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install + all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib + directory. -*********************************************************************** - -SECTION III: Building and testing HDF5 C and C++ Library on command - line with Intel C++ Compiler 8.1 integration with - Microsoft Visual C++ .Net 2003 - -************************************************************************ +======================================================================== + SECTION III: Building and testing HDF5 C and C++ Library on command + line with Intel C++ Compiler 8.1 integration with + Microsoft Visual C++ .Net 2003 +======================================================================== 1. Extra Preconditions: @@ -372,10 +371,10 @@ SECTION III: Building and testing HDF5 C and C++ Library on command 1.3 Run batch file copy_hdf.bat. - Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This process - will copy all the necessary batch files and text files saved under - c:\MyHDFstuff\hdf5\windows directory to the directories where they - will be used. + Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. This + process will copy all the necessary batch files and text files + saved under c:\MyHDFstuff\hdf5\windows directory to the + directories where they will be used. 1.4 Convert project files format from MSVS 6.0 to MSVS .Net Format @@ -400,14 +399,17 @@ SECTION III: Building and testing HDF5 C and C++ Library on command 2.1 Options A: Build and test in one step - A batch file named hdf5bt_intelc.bat in c:\MyHDFstuff\hdf5 directory - is provided for users to build and test HDF5 library and tools - together from command line. + A batch file named hdf5bt_intelc.bat in c:\MyHDFstuff\hdf5 + directory is provided for users to build and test HDF5 library + and tools together from command line. - Invoke a command prompt window and run hdf5bt_intelc in the - following format to build and test C/C++ libraries and tools. + Invoke a command prompt window and run hdf5bt_intelc.bat with + one of the following options: - hdf5bt_intelc enablecpp + hdf5bt_intelc Build and Test HDF5 C Library and + Tools + hdf5bt_intelc enablecpp Build and Test HDF5 C/C++ Library + and Tools Test results will be saved in two files: @@ -444,11 +446,11 @@ SECTION III: Building and testing HDF5 C and C++ Library on command directory is provided for users to build HDF5 library and tools from command line. - Invoke a command prompt window and run hdf5build_intelc - in the following format to build HDF5 C/C++ libraries and - tools. + Invoke a command prompt window and run hdf5build_intelc.bat + with one of the following options. - hdf5build_intelc enablecpp + hdf5build_intelc Build HDF5 C Library and Tools + hdf5build_intelc enablecpp Build HDF5 C/C++ Library and Tools Compiling outputs are saved in c:\MyHDFstuff\hdf5\build_results_intelc.txt. You can check @@ -459,31 +461,30 @@ SECTION III: Building and testing HDF5 C and C++ Library on command Go to directory, run batch file hdf5check with the following options: - hdf5check test HDF5 C library and tools - - hdf5check enablecpp test HDF5 C/C++ libraries - and tools + hdf5check Test HDF5 C Libraries and Tools + hdf5check enablecpp Test HDF5 C/C++ Libraries and Tools Notes: hdf5check.bat has ONLY TWO options listed above in this case. - Test results are saved in two files: + 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 + In general, you only need to check tests_results.txt. If all 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. 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. + 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. Please send email to hdfhelp@ncsa.uiuc.edu for further assistance. -- cgit v0.12