diff options
author | Scott Wegner <swegner@hdfgroup.org> | 2007-08-02 20:06:31 (GMT) |
---|---|---|
committer | Scott Wegner <swegner@hdfgroup.org> | 2007-08-02 20:06:31 (GMT) |
commit | 7f2265149224ffa99b7a9825d4faf0b4823f4562 (patch) | |
tree | 3f5701d0e5360007fa3a834b487c7656eabbe018 /release_docs | |
parent | 82e6cac79aa902301900443bcca8d4720354d05d (diff) | |
download | hdf5-7f2265149224ffa99b7a9825d4faf0b4823f4562.zip hdf5-7f2265149224ffa99b7a9825d4faf0b4823f4562.tar.gz hdf5-7f2265149224ffa99b7a9825d4faf0b4823f4562.tar.bz2 |
[svn-r14034] Purpose: Remove forced symbol "gethostname@8" from Windows projects
Description:
Previously, we needed to force symbol definition "gethostname@8" for compatibility with old versions of Visual Studio. It appears that Visual Studio no longer requires this, so we remove it. This makes the build process on 64-bit much smoother.
Also minor updates to main documentation, command-line documentation, and removed codewarrior and INTEL docs.
Tested:
VS.NET
VS2005
chkmanifest
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/INSTALL_Windows.txt | 8 | ||||
-rwxr-xr-x | release_docs/INSTALL_Windows_From_Command_Line.txt | 359 | ||||
-rwxr-xr-x | release_docs/INSTALL_Windows_Short_INTEL.TXT | 392 | ||||
-rw-r--r-- | release_docs/INSTALL_codewarrior.txt | 74 |
4 files changed, 38 insertions, 795 deletions
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index 0850ff1..466a5fe 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -1831,13 +1831,7 @@ Building: 4.3 Modify Project Settings - Similar to Step 3.3, we must remove "gethostname@8" from the list of - "Force Symbol References" for each project that has it. Although - tedious, this must be done, or Visual Studio will issue a linker - error. For Visual Studio 2005, this must be done for both debug - and release versions. In .NET, we only build release. - - In .NET, we also need to add "bufferoverflowU.lib" as a dependency + In .NET, we need to add "bufferoverflowU.lib" as a dependency for several projects. You can simply add it to all projects that produce an executable or dll, or identify specific projects that need it at build-time because they will fail with a link error diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index e49c791..c58229b 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -9,33 +9,15 @@ Note: This instruction is written for users who would like to build HDF5 Currently, we support 1. Building and testing HDF5 on command line with Microsoft Visual - C++ 6.0 and Compaq Visual Fortran 6.0. + Studio .NET - 2. Building and testing HDF5 C and C++ Library on command line with - Microsoft Visual C++ .Net (2003) - - 3. Building and testing HDF5 C and C++ Library on command line with - Intel C++ Compiler 8.1 integration with Microsoft Visual C++ .Net - 2003. 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. - - 4. Different compiler is using different batch files on command line - to build HDF5 Libraries. - - Compiler Name Batch File to Be Used - - MSVS 6.0 hdf5bt.bat hdf5build.bat - MSVS .Net hdf5bt_net.bat hdf5build_net.bat - Intel C++ hdf5bt_intelc.bat hdf5build_intelc.bat - - Be careful to type in the corresponding command when you choose - a procedure below to build HDF5 Libraries. - + WARNINGS: Please read CAREFULLY about HDF5 build and install preconditions and @@ -44,22 +26,22 @@ notes in INSTALL_Windows.txt before starting below procedures. ======================================================================== Section I: Building and testing HDF5 on command line with Microsoft - Visual C++ 6.0 and Compaq Visual Fortran 6.0. + Visual Studio .NET ======================================================================== 1. Preconditions: - 1.1 Set path for Visual C++ 6.0 and Compaq Visual Fortran 6.0 + 1.1 Verify environment for Visual Studio .NET - 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 Compaq Visual Fortran 6.0 path (For example, - C:\Program Files\Microsoft Visual Studio\Common\MSDev98\Bin\) - into "Variable Value" and click "OK". + Building from the command line requires environment variables for Visual + Studio. These are generally setup when Visual Studio is installed, but you + can verify by running the command: + + echo %vs71comntools% + + This should output a path similar to: + + C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools\ 1.2 Run batch file copy_hdf.bat. @@ -72,41 +54,29 @@ notes in INSTALL_Windows.txt before starting below procedures. 2.1 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: + 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 build and test C library and tools + hdf5bt.bat currently takes no parameters: - hdf5bt enablecpp build and test C/C++ libraries - and tools + hdf5bt build and test C/C++ library and tools - hdf5bt enablefortran build and test C/Fortran libraries - and tools + Invoke a command prompt window and run hdf5bt. Test results are saved + in two files: - 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\check_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. + 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. 2.2 Options B: Build and test in two steps - We also provide users with the option to build and test - HDF5 libraries and tools seperately. + We also provide users with the option to build and test HDF5 libraries + and tools seperately. Step 1) Build HDF5 Libraries and Tools @@ -114,25 +84,13 @@ notes in INSTALL_Windows.txt before starting below procedures. directory is provided for users to build HDF5 library and tools from command line. - hdf5build.bat has four options: + hdf5build.bat currently takes no parameters: - 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 build HDF5 C/C++ library 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. + Invoke a command prompt window and run hdf5build. 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 @@ -152,8 +110,8 @@ notes in INSTALL_Windows.txt before starting below procedures. hdf5check enableall Test HDF5 C/C++/Fortran Libraries and Tools - Invoke a command prompt window and run hdf5check with - appropriate options. + Invoke a command prompt window and run hdf5check with apropriate + options. Test results are saved in two files: @@ -161,10 +119,10 @@ notes in INSTALL_Windows.txt before starting below procedures. 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 @@ -174,249 +132,6 @@ 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: - - 1.1 Microsoft Visual C++ .Net 2003 Installed - - 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++ - .Net 2003 format. - - 1.3 Set path for Microsoft Visual C++ .Net - - 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". - - 1.4 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. - -2. Building HDF5 C and C++ 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 - - A batch file named hdf5bt_net.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_net with one of the - options below to build and test desired library: - - 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: - - c:\MyHDFstuff\hdf5\hdf5_results_net.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_net.txt. If some tests failed, check - hdf5_results_net.txt can help you figure out what was wrong. - - 2.2 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_net.bat in c:\MyHDFstuff\hdf5 - directory is provided for users to build HDF5 library and - tools from command line. - - 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 - the file to find out whether there are any compilation - errors. - - Step 2) Build HDF5 Libraries and Tools - - 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 - - Note: hdf5check.bat has ONLY TWO options listed above in this case. - - 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. - - 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. - -======================================================================== - 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: - - 1.1 Set path for Microsoft Visual C++ .Net and Intel C++ 8.1 - - 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) - and Intel C++ 8.1 path (For example, - C:\Program Files\Intel\CPP\Compiler80\Ia32\Bin) - into "Variable Value" and click "OK". - - 1.2 Install ICProjConvert80 Utility and set its path - - Intel provided this utility to convert a solution or project(s) - in a solution from the Visual C++ .Net project system to the - Intel C++ Compiler project system. - - Users who have not install this utility, can open - IntelC++Compiler81 package, go to directory "IA32", - open Data1.zip with 7zip or WinZip, find ICProjConvert80.exe and - extract it to a corresponding directory. For example, - C:\Program Files\Intel\CPP\Compiler80\Ia32\Bin - - Refer to 1.1 and set path for utility ICProjConvert80. - - 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. - -2. Building HDF5 C and C++ Libraries : - - We provide 2 options for users to build HDF5 libraries and tools. - - 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. - - Invoke a command prompt window and run hdf5bt_intelc.bat with - one of the following options: - - 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: - - c:\MyHDFstuff\hdf5\hdf5_results_intelc.txt - - c:\MyHDFstuff\hdf5\tests_results.txt. - - Project conversion results from MSVS .Net format to Intel C++ fomat - - will be saved in - - c:\MyHDFstuff\hdf5\convert_intel.log - - Check convert_intel.log to see if all of the project files have - been converted successfully. Conversion messages should look - like: - - "projname.vcproj": has been converted from Microsoft VC++ - project system to the Intel C++ 8.x project system. - - In general, you only need to check tests_results.txt. - If all the tests passed, then you do not have to check - hdf5_results_intelc.txt. If some tests failed, check - hdf5_results_intelc.txt can help you figure out what was wrong. - - 2.2 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_intelc.bat in c:\MyHDFstuff\hdf5 - directory is provided for users to build HDF5 library and - tools from command line. - - Invoke a command prompt window and run hdf5build_intelc.bat - with one of the following options. - - 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 - the file to find out whether there are any compiling errors. - - Step 2) Testing HDF5 Libraries and Tools - - Go to directory, run batch file hdf5check with the following - options: - - 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: - - c:\MyHDFstuff\hdf5\tests_results.txt - - c:\MyHDFstuff\hdf5\check_results.txt. - - 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. - *********************************************************************** For further information, please refer to INSTALL_WINDOWS.txt. diff --git a/release_docs/INSTALL_Windows_Short_INTEL.TXT b/release_docs/INSTALL_Windows_Short_INTEL.TXT deleted file mode 100755 index 9c45d23..0000000 --- a/release_docs/INSTALL_Windows_Short_INTEL.TXT +++ /dev/null @@ -1,392 +0,0 @@ -************************************************************************ -*HDF5 Build and Install Instructions for Windows XP with INTEL Compiler* -* (Short Version) * -************************************************************************ - -Notes: This short instruction is written for users who want to quickly - build HDF5 library and tools from the HDF5 source code package - with Intel Fortran 9.1 Compiler with Microsoft Visual Studio .NET or 2005 - 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. - - We no longer support the Intel C compiler, Intel Fortran 7.x or 8.x. - However, if you would still like to use one of these compilers, - documentation is available online at - http://hdfgroup.org/windows/docs/hdf518/dep/Install_Windows_Dep_Intel.txt - -WARNINGS: - Please read CAREFULLY about HDF5 build and install preconditions - and notes in INSTALL_Windows.txt before starting reading this - instruction. - -======================================================================== - Extra Preconditions and Notes -======================================================================== - - a. Setup Szip Library for Intel Compiler. - - Intel compilers use different Szip library from other compilers. - Szip source codes or binaries for Intel compiler can be downloaded - from the following address: - - ftp://ftp.hdfgroup.org/lib-external/szip/2.0/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. Instead, read Section V of Install_Windowx.txt. - - You have to read this part even if you want to use only Zlib - or Szip. You also need to read Section V of Install_Windowx.txt. - - Invoke Microsoft Visual C++ .Net 2003 or 2005. From the main - menu, Go to Tools > Options > Intel(R) Fortran. - In the right panel, make sure your "Selected Compiler" is Intel Fortran 9.1. - Click the right-most box for "Libraries", - Add Zlib and Szip Library Path (c:\zlib123\lib, c:\szip\dll for example) - Click rightmost box for "Includes", - Add Zlib and Szip header path (c:\zlib123\include c:\szip\include, for example). - Then click "OK". - -======================================================================== - Part I. Build with Intel Fortran - Compiler 9.1 under MSVS C++ .Net 2003 / 2005 Environment -======================================================================== - - Note: This step will build HDF5 Static and DLL C and C++ - Library using .Net 2003 or Visual Studio 2005 Compiler as well as - HDF5 Static and High Level Fortran Library using Intel - Fortran 9.1 Compiler. - - - 1.1 Open all.dsw and Convert Project Files (.dsp) to Visual - C++ .Net Format (.vcproj) - - Invoke Microsoft Visual C++ .Net or 2005. 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, choose "Yes To All" to convert all project files - to Visual C++ .Net project format. - - 1.2 Extract Compaq Fortran Project Files - - a. Select project "flush1_fortran" in the Solution Explorer - window. In the Project menu, select - "Extract Compaq Visual Fortran Project". - - Do the same thing for the following project files, but for now, skip - the projects labelled "**SKIP**": - - flush1_fortrandll - flush2_fortran - flush2_fortrandll - hdf5_fortran - hdf5_fortrandll - **SKIP** libtest_fortran - libtest_fortrandll - testhdf5_fortran - testhdf5_fortrandll - **SKIP** hdf5_hl_fortran - hdf5_hl_fortrandll - hl_test_image_fortran - hl_test_image_fortrandll - hl_test_lite_fortran - hl_test_lite_fortrandll - hl_test_table_fortran - hl_test_table_fortrandll - - - b. Select project "libtest_fortran" in the Solution - Explorer window. In the Project menu, select - "Extract Compaq Visual Fortran Project". Since Project - file "libtest_fortran" contain both C and Fortran code, - you will be asked to specify which project, either - Fortran or C/C++, will serve as the main project for - this mixed language projects. Choose - "The Intel Fortran project" as the the main project and - click "OK". - - Do the same thing for hdf5_hl_fortran. - - 1.3 Add project dependencies - - - To check the project dependencies: - - Right click the selected project, you should see "Project Dependencies" - on the menu, click "Project Dependencies", You should see a "Project - Dependencies" panel, with the selected project and the projects it - depends on checked under "Depends on" list. - - Each of the following projects will need libtest_fortran_lib added - to its list of dependencies: - - libtest_fortran - flush1_fortran - flush2_fortran - testhdf5_fortran - - Each of the following projects will need hdf5_hl_fortran_lib added - to its list of dependencies: - - hdf5_hl_fortran - hl_test_image_fortran - hl_test_lite_fortran - hl_test_table_fortran - - - 1.4 Change Project Output - - Right click on the project "hdf5_hl_fortran" and select - "Properties". At the top left of the Property Pages, select - "Debug" for the Configuration. Then, in the left pane, go to - Librarian > General. Change the Output File from - "$(OutDir)/$(ProjectName).lib" to "$(OutDir)/$(ProjectName)d.lib". - Then click Ok. - - Similarly, right-click on "hdf5_hl_fortran_lib", and select - "Properties". At the top left of the Property Pages, select - "Debug" for the Configuration. Then, in the left pane, go to - Librarian > General. Change the Output File from - "..\..\..\proj\hdf5_hl_fortran\Debug\hdf5_hl_fortrand.lib" - to ..\..\..\proj\hdf5_hl_fortran\Debug\hdf5_hl_fortrand_lib.lib". - - Then, in the top left corner again, change the Configuration to - "Release". Inside of Librarian > General, change the Output File - from ".\..\..\..\proj\hdf5_hl_fortran\Release\hdf5_hl_fortran.lib" - to ".\..\..\..\proj\hdf5_hl_fortran\Release\hdf5_hl_fortran_lib.lib". - - - - 1.5 Building HDF5 C/C++/Fortran Libraries and Tools - - Select "Build", then Select "Configuration Manager". - - Select "Debug" or "Release" - - Disable ttsafedll - - - Select "ok". Select "Build" -> "Build" or "Rebuild All" to - build Debug or Release version of HDF5 C, C++, fortran - Library using Intel Fortran 9.1 Compiler with .Net 2003 or 2005. - -======================================================================== - Part II. Test HDF5 Static and High Level Fortran Library -======================================================================== - - We provide 2 options for users to test HDF5 libraries and tools. - - Option 1: Automatic testings - - HDF5 comes with various test suites, all of which can be tested - with hdf5check.bat batch file in c:\MyHDFstuff\hdf5 directory. - - hdf5check batch file can used to test HDF libraries with Fortran with - the following options: - - hdf5check enablefortran test HDF5 C/FORTRAN libraries and - tools - - - hdf5check enableall test HDF5 C/C++/FORTRAN libraries - and tools - To use this option, HDF5 C++ and - Fortran libraries must have been - built. - - Invoke a command prompt window and run hdf5check with appropriate - option. - - Test results are saved in two files: - - c:\MyHDFstuff\hdf5\check_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 check_results.txt. - If some tests failed, check check_results.txt can help you - figure out what was wrong. - - - Option 2: Step-by-step HDF5 libraries and tools testings - - Note: This section provides step-by-step instructions for testing the - Fortran librariy and tools only. To test the rest of the HDF5 library - and tools, please see Section II, Step 2 of Install_Windowx.txt. - - - a. Test HDF5 Static Fortran Library - - Go to directory c:\myHDFstuff\hdf5\fortran\test, Run batch file - testhdf5_fortran.bat with the following two options to test - fortran static library - - testhdf5_fortran release >> "Your output file name" - testhdf5_fortran debug >> "Your output file name" - - Check your output files, there should be no "failures" at all. - - b. Test HDF5 High Level Fortran Library - - Go to directory c:\myHDFstuff\hdf5\hl\fortran\test, Run batch file - testhdf5_fortran.bat with the following two options to test - fortran static library - - test_hdf5_hl_fortran release >> "Your output file name" - test_hdf5_hl_fortran debug >> "Your output file name" - - Check your output files, there should be no "failures" at all. - -======================================================================== - Part III. (Optional) Build HDF5 Fortan and HL Fortran Examples -======================================================================== - - Note: This section only covers building Fortran and HL Fortran examples. - For other examples, please see Section III of Install_Windowx.txt. - - To build and test HDF5 Fortran example: - --------------------------------------- - - 1. Invoke the Intel Fortran Compiler 9.1 or above under Microsoft - Visual Studio development environment, go to "File" and select - the "Open Workspace" option. - - Then open the workspace - c:\MyHDFstuff\hdf5\windows\fortran\examples\allf90examples\allf90examples.dsw. - - 2. Select "Build", then Select "Set Active Configuration". - - 2.1 To build debug versions of Fortran examples. - - In "Project configurations", select "allf90examples -- Win32 Debug", - select "ok". Select "Build" -> "Build" or "Rebuild All" to - build debug version of project "allf90examples". - - 2.2 To build release versions of Fortran examples. - - In "Project configurations", select "allf90examples -- Win32 Release", - select "ok". Select "Build" -> "Build" or "Rebuild All" to - build release version of project "allf90examples". - - When the debug build or release build is done, there should be the - following subdirectories in c:\MyHDFstuff\hdf5\fortran\examples\ - - attreexampletest - attreexampletestdll - compoundtest - compoundtestdll - dsetexampletest - dsetexampletestdll - fileexampletest - fileexampletestdll - groupexampletest - groupexampletestdll - grpdsetexampletest - grpdsetexampletestdll - grpittest - grpittestdll - grpsexampletest - grpsexampletestdll - hyperslabtest - hyperslabtestdll - mountexampletest - mountexampletest - refobjexampletest - refobjexampletestdll - refregexampletest - refregexampletestdll - rwdsetexampletest - rwdsetexampletestdll - selecteletest - selecteletestdll - - 3. Invoke a command prompt window and run the batch file - Installf90Examples.bat which resides in the top level directory - (c:\MyHDFstuff\hdf5). This file creates 4 new directories, - f90examplesREL, f90examplesRELDLL, f90examplesDBG, and - f90examplesDBGDLL, in the c:\MyHDFstuff\fortran\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. - - - To build and test HDF5 High Level Fortran examples: - --------------------------------------------------- - - 1. Invoke Compaq Visual Fortran 9.1, open the workspace - - c:\MyHDFstuff\hdf5\windows\hl\fortran\examples\ (continue next line) - allhlf90examples\allhlf90examples.dsw - - 2. Select "Build", then Select "Set Active Configuration". - - 2.1 To build debug versions of High Level Fortran examples. - In "Project configurations", select - "allhlf90examples -- Win32 Debug", select "ok". Select - "Build" -> "Build" or "Rebuild All" to build debug version - of project "allhlf90examples". - - 2.2 To build release versions of Fortran examples. - In "Project configurations", select - "allhlf90examples -- Win32 Release", select "ok". Select - "Build" -> "Build" or "Rebuild All" to build release version - of project "allhlf90examples". - - When the debug build or release build is done, there should be the - following subdirectories in c:\MyHDFstuff\hdf5\hl\fortran\examples - - ex_lite - ex_litedll - - 3. Invoke a command prompt window and run the batch file - Install_hlf90examples.bat which resides in the top level directory - (c:\MyHDFstuff\hdf5). This file creates 4 new directories, - HLf90examplesRELEASE, HLf90examplesRELEASEDLL, HLf90examplesDEBUG, - and HLf90examplesDEBUGDLL, in the - c:\MyHDFstuff\hdf5\hl\fortran\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. - - 4. We provide a batch file named test_hl_f90examples.bat in - c:\MyHDFstuff\hdf5\hl\fortran\examples directory for you to test - HDF5 high level fortran examples. - - test_hl_f90examples.bat batch file has 4 options: - - Options purpose - - test_hl_f90examples release -- for release version - - test_hl_f90examples release dll -- for release DLL version - - test_hl_f90examples debug -- for debug version - - test_hl_f90examples debug dll -- for debug DLL version - - Invoke a command prompt window and run test_hl_f90examples with - appropriate options. - - When you run "test_hl_f90examples release", the output will look - like: - - release version of High Level Fortran examples PASSED - - Similar messages should be generated with another three options - If the high level Fortran examples are built successfully. - - - -*********************************************************************** -Please send email to help@hdfgroup.org for further assistance. - diff --git a/release_docs/INSTALL_codewarrior.txt b/release_docs/INSTALL_codewarrior.txt deleted file mode 100644 index f548590..0000000 --- a/release_docs/INSTALL_codewarrior.txt +++ /dev/null @@ -1,74 +0,0 @@ - -Instructions for Building the HDF5 Library, Tests, and Tools -with the Metrowerks Code Warrior Compiler ---------------------------------------------------------------------------- - -The HDF5 library is supported under the Metrowerks Code Warrior version 8.0 compiler. -The Code Warrior port of the HDF5 library has been tested only on the -Windows NT platform. -The following instructions assume we will be using the path D:\hdf5 for installing the library. - ------------------------------------------------------------------------- -Pre conditions: -------------------------------------------------------------------------- -Both the ZLIB and SZIP libraries are needed to link with HDF5. -The Code Warrior project file settings assumes ZLIB is intalled in D:\zlib\zlib.lib -and SZIP is installed in D:\szip\codewarrior\szip.lib -These precompiled libraries can be obtained from the HDF web site, -please see hdf.ncsa.uiuc.edu for downloading instructions. -If you do not have these libraries installed on these locations, you must change -the path in the Project Settings (menu Edit->Settings->Target->Access Paths) - -------------------------------------------------------------------------- -Setup --------------------------------------------------------------------------- - -1. This setup assumes that you installed the distribution zip file as - explained in INSTALL_windows.txt file. The steps are - a) making a folder called <my install>/hdf5/ as your base hdf5 folder - b) unpack the file all.zip located in d:\hdf5\windows to d:\. - This file contains the Windows specific files of HDF5. - -To build the HDF5 library with Code Warrior: -1. Open the project file hdf5.mcp (located in d:\hdf5\proj\codewarrior\). -2. To build the library: - Select the 'hdf5' target and build (menu Projects-> Make or F7 key). -3. To build all the targets (HDF5 library, test, and tools): - Select the 'all' target and build. -4. To run the tests in a command line window: - In the command line window, change directory to d:\hdf5\test\. - Type - Hdf5test debug - or, to redirect the output to a file called myfile.txt, - Hdf5test debug > myfile.txt - The test and tools files are generated in the same directory as - those compiled with the Microsoft Visual Studio compiler. - - ---------------------------------------------------------------------------- -Known problems ---------------------------------------------------------------------------- - -The test "testhdf5" fails on a open file call. This is caused by a CodeWarrior v8.0 -bug in the "open" function - -Metrowerks provides a patch for this error - -1) Edit the file file_io.win32.c, located on <MY_INSTALL\MSL\MSL_C\MSL_Win32\Src\> - -2) Change the following symbol to 1 instead of 0 - -#define _MSL_ALLOW_SHARED_WRITING 0 -/* Set this value to 1 for file opening with shared writing */ - -3) Add this source code to your project and relink it with your application. - A source code in a project overrides the library source. - - - ---------------------------------------------------------------------------- -The HDF Group would like to thank Ron Liechty of Metrowerks technical -support for all the help provided during the development of this project. - - - |