summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
Diffstat (limited to 'release_docs')
-rw-r--r--release_docs/INSTALL_Windows.txt8
-rwxr-xr-xrelease_docs/INSTALL_Windows_From_Command_Line.txt359
-rwxr-xr-xrelease_docs/INSTALL_Windows_Short_INTEL.TXT392
-rw-r--r--release_docs/INSTALL_codewarrior.txt74
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.
-
-
-