From dc76133bb11a114488ac58454f2a9bf6dfa2e1fb Mon Sep 17 00:00:00 2001 From: Scott Wegner Date: Mon, 26 Feb 2007 15:43:21 -0500 Subject: [svn-r13397] Various updates to bring Windows documentation up to date. --- release_docs/INSTALL_Cygwin.txt | 10 +- release_docs/INSTALL_Windows.html | 7963 +++++++++++++------- release_docs/INSTALL_Windows.txt | 89 +- .../INSTALL_Windows_From_Command_Line.html | 1658 ++-- release_docs/INSTALL_Windows_From_Command_Line.txt | 33 +- release_docs/INSTALL_Windows_Short_INTEL.TXT | 4 +- release_docs/INSTALL_Windows_Short_Intel.htm | 1001 ++- release_docs/INSTALL_Windows_Short_MSVS6.0.TXT | 2 +- release_docs/INSTALL_Windows_Short_MSVS6.0.htm | 593 +- release_docs/INSTALL_Windows_Short_NET.TXT | 7 +- release_docs/INSTALL_Windows_Short_Net.htm | 1033 ++- 11 files changed, 7887 insertions(+), 4506 deletions(-) diff --git a/release_docs/INSTALL_Cygwin.txt b/release_docs/INSTALL_Cygwin.txt index 52541ed..b63d294 100644 --- a/release_docs/INSTALL_Cygwin.txt +++ b/release_docs/INSTALL_Cygwin.txt @@ -66,11 +66,11 @@ Preconditions: the extended-Rice lossless compression algorithm for chunked datatsets. For more information about Szip compression and license terms see - http://hdf.ncsa.uiuc.edu/HDF5/doc_resource/SZIP/index.html. + http://hdfgroup.org/HDF5/doc_resource/SZIP/index.html. The latest supported public release of SZIP is available from - ftp://hdf.ncsa.uiuc.edu/szip/2.0. Binary distribution can be - found under ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin + ftp://ftp.hdfgroup.org/lib-external/szip/2.0. Binary distribution can be + found under ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/cygwin Install HDF5 on Cygwin @@ -78,7 +78,7 @@ Install HDF5 on Cygwin 1. Get HDF5 source code package Users can download HDF5 source code package from HDF website - (http://hdf.ncsa.uiuc.edu). + (http://hdfgroup.org). 2. Unpacking the distribution @@ -236,4 +236,4 @@ Install HDF5 on Cygwin ----------------------------------------------------------------------- -Need Further assistance, email hdfhelp@ncsa.uiuc.edu +Need Further assistance, email help@hdfgroup.org diff --git a/release_docs/INSTALL_Windows.html b/release_docs/INSTALL_Windows.html index 128eecc..fea6cdb 100755 --- a/release_docs/INSTALL_Windows.html +++ b/release_docs/INSTALL_Windows.html @@ -1,3099 +1,5466 @@ + + - + + + + + + + HDF5 Build and Install Instructions for Windows XP (Full +Version) - - - - -HDF5 Build and Install Instructions for Windows XP (Full Version) - + + -

HDF5 Build and Install Instructions for Windows XP (Full Version)

+

HDF5 Build and Install Instructions for Windows XP (Full +Version)

+

Notes:

-

The following instructions assume that the HDF5 source code package from -HDF website (http://hdf.ncsa.uiuc.edu) is used.

-

Table of Contents:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + +

The following instructions assume that the +HDF5 source code package from HDF website (http://hdfgroup.org) +is used.

+ +

Table of Contents:

+ +

Preconditions

-

Section I   

- 		-

  What do we build and install

-
-

Section II  

- 		-

  How to build and test HDF5 libraries and tools

-
-

Section III 

- 		-

  How to Build Examples (Optional)

-
-

Section IV 

- 		-

  How to build an application using the HDF5 -library or DLL

-
-

Section V  

- 		-

  How to disable Gzip(Zlib)/Szip compression

-
-

Section VI 

- 		-

  How to build HDF5 in .NET 2003

-
-

Section VII

- 		-

  How to build HDF5 with INTEL Compiler

-
-

Section VIII

- 		-

  How to build Multi-threaded version of HDF5 -library

-
-

Section IX 

- 		-

  How to build and test HDF5 snapshot release

-
-

Section X  

- 		-

 How to build HDF5 with Thread-Safe Feature

-
-

Section XI  

- 		-

  Misc.

-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+

Preconditions

+ +
+

Section +I   

+ + 		+

  What do we +build and install

+ +
+

Section +II  

+ + 		+

  How to +build and test HDF5 libraries and tools

+ +
+

Section +III 

+ + 		+

  +How to Build Examples (Optional)

+ +
+

Section IV 

+ + 		+

  How to +build an application using the HDF5 library or DLL

+ +
+

Section +V  

+ + 		+

  How to +disable Gzip(Zlib)/Szip compression

+ +
+

Section VI 

+ + 		+

  How to +build HDF5 in .NET 2003

+ +
+

Section VII

+ + 		+

  How to +build HDF5 with INTEL Compiler

+ +
+

Section VIII

+ + 		+

  How to +build Multi-threaded version of HDF5 library

+ +
+

Section IX 

+ + 		+

  How to +build and test HDF5 snapshot release

+ +
+

Section +X  

+ + 		+

 How to +build +HDF5 with Thread-Safe Feature

+ +
+

Section +XI  

+ + 		+

  How to +build HDF5 in Visual Studio 2005

+ +
+

Section +XII  

+ + 		+

  Misc.

+ +
+

Preconditions

+
-

Please read CAREFULLY about the following preconditions and notes first.

-

1. Installed Microsoft Visual C++ 6.0 or Intel C compiler and WinZip.

+

Please read CAREFULLY about the following preconditions and +notes first.

+ +

1. Installed Microsoft Visual C++ 6.0 or Intel C +compiler and WinZip.

+
-

Installed Compaq Visual Fortran compiler(6.0 or higher version), or Intel Fortran -compiler if you want to build HDF5 Fortran libraries.

-

Notes:

-

By default, WinZip will convert the Unix end of line format when extracting .tar -file. This conversion will cause "false" failure in some HDF5 tools testings. Please -uncheck the "TAR file smart CR/LF conversion" option in your WinZip to prevent the -conversion when extracting .tar file. To uncheck the "TAR file smart CR/LF conversion" -option: Invoke WinZip, go to "Options", select "Configuration..." Click the "Miscellaneous" -tab and uncheck "TAR file smart CR/LF conversion" option, then click OK.

+

Installed Compaq Visual Fortran compiler(6.0 or higher +version), or Intel Fortran compiler if you want to build HDF5 Fortran +libraries.

+ +

Notes:

+ +

By default, WinZip will convert the Unix +end of line format when extracting .tar file. This conversion will +cause "false" failure in some HDF5 tools testings. Please uncheck the +"TAR file smart CR/LF conversion" option in your WinZip to prevent the +conversion when extracting .tar file. To uncheck the "TAR file smart +CR/LF conversion" option: Invoke WinZip, go to "Options", select +"Configuration..." Click the "Miscellaneous" tab and uncheck "TAR file +smart CR/LF conversion" option, then click OK.

+
-

2. Set up a directory structure to unpack the library.

+ +

2. Set up a directory structure to unpack the +library.

+

For example:

- - - - - - - +

c:\ (any drive)

-

MyHDFstuff\ (any folder name)

-
+ + + + + + + + + + + + + + + +
+

c:\ +(any drive)

+ +
+

MyHDFstuff\ +(any folder name)

+ +
+

 

-

3. Download the hdf5-1.8.x source code package

-

Use WinZip to extract the HDF5 package into c:\MyHDFstuff. -This creates a directory called 'hdf5-1.8.x' under MyHDFstuff -which contains several files and directories. Rename "hdf5-1.8.x" -to "hdf5".

-

4. HDF5 provide options to do in-memory compress within HDF5 library.

-

Currently, two external compression libraries Zlib and Szip can be used with -HDF5.

+

3. Download the hdf5-1.8.x source code package +

+ +

Use WinZip to extract the HDF5 package into c:\MyHDFstuff. This creates a +directory called 'hdf5-1.8.x' under MyHDFstuff +which contains several files and directories. Rename "hdf5-1.8.x" to "hdf5".

+ +

4. HDF5 provide options to do in-memory compress +within HDF5 library.

+ +

Currently, two external compression libraries Zlib and Szip +can be used with HDF5.

+ -

5. Define the following environment variables:

+ +

5. Define the following environment variables: +

+ -

In this section, Zlib and Szip compression packages are assumed to be used. Please -read Section V as well as this section if -you do not want to use compression feature inside HDF5.

+ +

In this section, Zlib and Szip compression packages are +assumed to be used. Please read Section +V as well as this section if you do not want to use +compression feature inside HDF5.

+

To define these environment variables:

-

Click "Start" -> "Control -Panel" -> "System" -> "Advanced"  --> "Environment -Variables". If you are logged on as administrator to the local computer AND -want to let all other users use these two environment variables, click -"New" under "System Variables" -box; otherwise, click "New" under -"User Variables" box. In the New Variable window, -set

-

"Variable name" as HDF5_EXT_ZLIB

-

"Variable value" as zdll.lib, -then click OK.

+ +

Click "Start" +-> "Control Panel" +-> "System" +-> "Advanced"  +-> "Environment Variables". +If you are logged on as administrator to the local computer AND want to +let all other users use these two environment variables, click +"New" under "System Variables" box; +otherwise, click "New" +under +"User Variables" box. +In the New Variable window, set

+ +

"Variable name" +as HDF5_EXT_ZLIB

+ +

"Variable value" +as zdll.lib, then +click OK.

+

Similarly, you can set:

-

HDF5_EXT_SZIP environment variable as + +

HDF5_EXT_SZIP +environment variable as szlibdll.lib

+

Notes:

+ -

6. 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++ and go to "Tools" and select "Options", find "Directories"; + +

6. 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++ and go to "Tools" and select +"Options", find "Directories";

+ +

Notes:

+ -

Go to TOP Preconditions

-

Go to Table of Contents

-
-

Section I: What do we build and install?

-
- -

Go to Table of Contents

+ +

Go +to TOP Preconditions

+ +

Go +to Table of Contents

+
-

Section II: How to build and test HDF5 libraries and tools -

+

Section I: What do we build +and install?

+
-

This section includes:

-

STEP 1: Building HDF5 libraries and tools

-

STEP 2: Testing HDF5 libraries and tools

-

STEP 3: Installing HDF5 Libraries

-

 

-

STEP 1: Building HDF5 libraries and tools

-

STEP 2: Testing HDF5 libraries and tools

-

HDF5 libraries and tools should be tested to make sure that they were built correctly.

-

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 be run with one of the following four options:

-
- - - - - - - - - - - - - - - - - - - - - -
OptionsIllustration
-

hdf5check

- 		-

test HDF5 C library and tools only

-
-

hdf5check enablecpp

- 		-

test HDF5 C/C++ libraries and tools.

-

To use this option, HDF5 C++ libraries must have been built in - step I.

-
-

hdf5check enablefortran

- 		-

test HDF5 C/FORTRAN libraries and tools

-

To use this option, HDF5 Fortran libraries must have been built in - step I.

-
-

hdf5check enableall

- 		-

test HDF5 C/C++/FORTRAN libraries and tools

-

To use this option, HDF5 C++ and Fortran libraries must have been built - in step I.

-
-
-

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

-

You can also test HDF5 libraries and tools one by one. There are four -versions of HDF5 libraries and tools testing. They are:

- -

We strongly suggest you to redirect your testing results into an output file -so that you can easily check the testing results. You may use either Notepad or -WordPad or whatever other windows word processor to check the results. For the purpose -of printing, please choose font less than 14 for better alignment of the text. -

-

DLLs listed below should be placed into the Windows system directory. A batch -file named install_dll.bat is included in -c:\MyHDFstuff\hdf5 directory. Run this batch file -and the following HDF5 DLLs will be copied to the system directory.

- - -

Go to TOP Section XI

-

Go to Table of Contents

-
-

Need further assistance? email to hdfhelp@ncsa.uiuc.edu or go to - http://hdf.ncsa.uiuc.edu/windows/questions to get help on windows

-

Thank  you  for  using  Hierarchical  Data  Format  (HDF)

-

 

-

 

- - -

+

Remember to undo 1 and 2 after you test if you are not +going to use 1.6 backward compatibility option.

+ + + +

Go to +TOP Section XII

+ +

Go +to Table of Contents

+ +
+

Need further assistance? email to help@hdfgroup.org +or go to http://hdfgroup.org/windows/questions +to get help on Windows

+ +

Thank  +you  for  using  Hierarchical  +Data  Format  (HDF)

+ +

 

+ +

 

+ +

+

+

- - \ No newline at end of file + diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index 51605f6..ce08b85 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -5,7 +5,7 @@ *********************************************************************** The following instructions assume that the HDF5 source code package from -HDF website (http://hdf.ncsa.uiuc.edu) is used. +HDF website (http://hdfgroup.org) is used. Warnings: Please read CAREFULLY about the following preconditions and notes first. @@ -71,7 +71,7 @@ Preconditions: 4.1 HDF5 uses Zlib version 1.2.2 for compression and Zlib is NOT distributed with HDF5 library in 1.8.x release. To use Zlib library, you have to install your own Zlib DLL library or go - to ftp://hdf.ncsa.uiuc.edu/lib-external/zlib/1.2/bin + to ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin to download the Zlib library. @@ -79,12 +79,12 @@ Preconditions: compression software is provided with HDF5 products in 1.8.0 release. To use Szip 2.0 library, you can download Szip source codes and binaries from - ftp://hdf.ncsa.uiuc.edu/lib-external/szip/2.0/bin/windows + ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows Please note that Szip is not a totally open-source free software. For licensing issue of Szip, please check "Licensing terms" at - http://hdf.ncsa.uiuc.edu/doc_resource/SZIP/index.html. + http://hdfgroup.org/doc_resource/SZIP/index.html. Szip compression feature inside HDF5 is optional. @@ -171,8 +171,8 @@ Notes: 6. HDF4-related tools are not built and released with HDF5 library packages any more. To obtain HDF4 related tools, please check - http://hdf.ncsa.uiuc.edu/h4toh5/ and - ftp://hdf.ncsa.uiuc.edu/HDF5/h4toh5/ + http://hdfgroup.org/h4toh5/ and + ftp://ftp.hdfgroup.org/HDF5/h4toh5 7. For DLL users, please do read and follow "DLL hints" at Section IV. @@ -188,8 +188,9 @@ Notes: 11. For users who would like to build, test and use HDF5 snapshot release, please read Section IX. - 12. For .Net and Intel users, if you are not in Section X How to build HDF5 with - Thread-Safe Feature, ttsafedll.dsp should be turned off always. + 12. For .Net and Intel users, if you are not building HDF5 with + Thread-Safe Feature (see Section X), ttsafedll.dsp should + always be turned off. ======================================================================== @@ -239,7 +240,7 @@ STEP 1: Building HDF5 libraries and tools 1. 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,windows specific + process will copy all the necessary batch files, windows specific source codes and text files saved under c:\MyHDFstuff\hdf5\windows directory to the corresponding directories under hdf5. @@ -347,9 +348,9 @@ STEP 1: Building HDF5 libraries and tools 4. Select "Build", then Select "Set Active Configuration". 4.1 To build debug versions of single-threaded static libraries, - Debug multithreaded DLLs and tests + Debug multithreaded DLLs and tests - In "Project configurations", select "all -- Win32 Debug", + In "Project configurations", select "all -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to build debug version of project "all". @@ -412,7 +413,7 @@ STEP 1: Building HDF5 libraries and tools toolslibD.lib- the internal DLL export library for tools c:\MyHDFstuff\hdf5\tools\"tools directory"- - where tools are located + where tools are located The directories listed below will contain the following files ONLY when you choose to build HDF5 C++ libraries: @@ -679,8 +680,8 @@ We provide 2 options for users to test HDF5 libraries and tools. b) release dll version type: - hdf5test release dll > "Your output filename" - + hdf5test release dll >"Your output filename" + c) debug static version type: hdf5test debug >"Your output filename" @@ -730,7 +731,7 @@ We provide 2 options for users to test HDF5 libraries and tools. type: testhdf5tools release dll output file: toolstest_releasedll.txt - + c) debug static version type: testhdf5tools debug @@ -859,10 +860,10 @@ We provide 2 options for users to test HDF5 libraries and tools. following HDF5 high level fortran DLLs will be copied to the system directory. -c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release\hdf5_hl_f90cstubdll.dll -c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug\hdf5_hl_f90cstubdlld.dll -c:\MyHDFstuff\hdf5\proj\hdf5_hlfortrandll\Release\hdf5_hlfortrandll.dll -c:\MyHDFstuff\hdf5\proj\hdf5_hlfortrandll\Debug\hdf5_hlfortrandlld.dll + c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Release\hdf5_hl_f90cstubdll.dll + c:\MyHDFstuff\hdf5\proj\hdf5_hl_f90cstubdll\Debug\hdf5_hl_f90cstubdlld.dll + c:\MyHDFstuff\hdf5\proj\hdf5_hlfortrandll\Release\hdf5_hlfortrandll.dll + c:\MyHDFstuff\hdf5\proj\hdf5_hlfortrandll\Debug\hdf5_hlfortrandlld.dll Run test_hdf5_hl_fortran.bat in the hdf5\hl\fortran\test directory at the command prompt as below: @@ -927,13 +928,13 @@ To build and test HDF5 C examples: 2.1 To build debug versions of C examples. In "Project configurations", select "allexamples -- Win32 Debug", - select "ok". Select "Build" -> "Build" or "Rebuild All" to - build debug version of project "allexamples". + select "ok". Select "Build" -> "Build" or "Rebuild All" to + build debug version of project "allexamples". 2.2 To build release versions of C examples. - In "Project configurations", select "allexamples -- Win32 Release", - select "ok". Select "Build" -> "Build" or "Rebuild All" to - build release version of project "allexamples". + In "Project configurations", select "allexamples -- Win32 Release", + select "ok". Select "Build" -> "Build" or "Rebuild All" to + build release version of project "allexamples". When the debug build or release build is done, there should be the following subdirectories in c:\MyHDFstuff\hdf5\examples\ @@ -1004,8 +1005,8 @@ To build and test HDF5 C++ examples: 2.2 To build release versions of C++ examples. In "Project configurations", select "allcppexamples -- Win32 Release", - select "ok". Select "Build" -> "Build" or "Rebuild All" to - build release version of project "allcppexamples". + select "ok". Select "Build" -> "Build" or "Rebuild All" to + build release version of project "allcppexamples". When the debug build or release build is done, there should be the following subdirectories in c:\MyHDFstuff\hdf5\c++\examples\ @@ -1131,13 +1132,13 @@ c:\MyHDFstuff\hdf5\windows\hl\examples\allhlcexamples\allhlcexamples.dsw 2. Select "Build", then Select "Set Active Configuration". 2.1 To build debug versions of High Level C examples. - In "Project configurations", select + In "Project configurations", select "allhlcexamples -- Win32 Debug", select "ok". Select "Build" -> "Build" or "Rebuild All" to build debug version of project "allhlcexamples". 2.2 To build release versions of C examples. - In "Project configurations", select + In "Project configurations", select "allhlcexamples -- Win32 Release", select "ok". Select "Build" -> "Build" or "Rebuild All" to build release version of project "allhlcexamples". @@ -1425,7 +1426,7 @@ Warning: When you modify the H5pubconf.h file as described below, #define H5_HAVE_FILTER_DEFLATE 1 then save the file. - + 1.2 Delete HDF5_EXT_ZLIB environment variable if you have set it in preconditions. @@ -1450,9 +1451,9 @@ Warning: When you modify the H5pubconf.h file as described below, #define H5_HAVE_SZLIB_H 1 #define H5_HAVE_FILTER_SZIP 1 - + then save the file. - + 2.2 Delete HDF5_EXT_SZIP environment variable if you have set it in preconditions. @@ -1481,7 +1482,7 @@ Warning: When you modify the H5pubconf.h file as described below, Szip library is different if you want to disable Szip encoder. Download szip_noencoder binaries from - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows. + ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows. The Szip library and header path should also be set up accordingly (refer to precondition 6). @@ -1680,7 +1681,7 @@ Notes: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and HDF5-1.8.x. 2. HDF5 Fortran DLL Libraries is not supported with Intel - Fortran 8.1 integration with Visual C++ .Net 2003 + Fortran 8.1 integration with Visual C++ .Net 2003 Environment. But Release version of HDF5 Fortran DLL libraries works with Intel Fortran Compiler while Debug version doesn't. @@ -1688,7 +1689,7 @@ Notes: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and 3. Szip library is different when using Intel compiler. You should build Szip source codes with Inter compiler or download binaries for Intel compiler from - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows. + ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows. 4. Run hdf5/windows/copy_hdf.bat first before open all.dsw. @@ -1714,7 +1715,7 @@ Notes: 1. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and Szip source codes or binaries for Intel compiler can be downloaded from the following address: - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows. + ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows. b. Set up path for external libraries and headers @@ -1994,15 +1995,15 @@ H5Tinit.c can be sucesessfully created by other compilers. 1. Previous step: Section II, step 1(1). 2. Extra steps: - 1) Open c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. + 1) Open c:\myHDFstuff\hdf5\windows\misc\typegen\typegen.dsw. - 2) Build the project file. + 2) Build the project file. - 3) Invoke command prompt and go to c:\myHDFstuff\hdf5\src. + 3) Invoke command prompt and go to c:\myHDFstuff\hdf5\src. - 4) type H5Tinit.exe >H5Tinit.c + 4) type H5Tinit.exe >H5Tinit.c - 5) Go back to Section II, continue with step 1(2). + 5) Go back to Section II, continue with step 1(2). Step II: Generate H5f90i_gen.h and H5fortran_types.f90 using Compaq Visual Fortran 6.6c @@ -2252,9 +2253,9 @@ Section XI: How to build HDF5 in Visual studio 2005 on windows 32-bit and 64-bit pay attention to the following reminders: 1) To use zlib or szlib compression packages: Use zlib 1.2.2 DLL provided at - ftp://ftp.ncsa.uiuc.edu/HDF/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz + ftp://ftp.hdfgroup.org/lib-external/zlib/1.2/bin/zlib122-windows.tar.gz Use szlib 2.0 DLL provided at - ftp://ftp.ncsa.uiuc.edu/HDF/lib-external/szip/2.0/bin/windows/xp-net/ + ftp://ftp.hdfgroup.org/lib-external/szip/2.0/bin/windows/xp-net 2) Make sure that WIN32 macro is set at visual studio 2005. 3) You may use _CRT_SECURE_NO_DEPRECATE to disable the warnings. Please refer to Section VI: How to build HDF5 in Visual Studio .Net 2003. @@ -2265,7 +2266,7 @@ Section XI: How to build HDF5 in Visual studio 2005 on windows 32-bit and 64-bit Section XII: Misc. ======================================================================== -1. drivers we support +1. Drivers we support The default driver on windows we support is sec2 driver. However, stdio driver is also supported. If you want to use stdio driver in your @@ -2362,4 +2363,4 @@ using the Visual C++ Development Environment. Remember to undo 1 and 2 after you test if you are not going to use 1.6 backward compatibility option. ************************************************************************ - Please send email to hdfhelp@hdfgroup.org for further assistance. + Please send email to help@hdfgroup.org for further assistance. diff --git a/release_docs/INSTALL_Windows_From_Command_Line.html b/release_docs/INSTALL_Windows_From_Command_Line.html index 5154bb7..e0a88a8 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.html +++ b/release_docs/INSTALL_Windows_From_Command_Line.html @@ -1,710 +1,1038 @@ - - - - - - -Instructions for Building and Testing HDF5 from Command Line on Windows XP - + + + + + + - - -

Instructions for Building and Testing HDF5 on Windows XP

from Command Line

-
+

Notes:

-

1. This instruction is written for users who would like to build HDF5 - libraries and tools from the HDF5 source code package on command - line. + +

1. This instruction is written for users who would like to +build HDF5 libraries and tools from the HDF5 source code package on +command line.

-

2. Currently, we support:

- -

3. Please read CAREFULLY about HDF5 build and install preconditions and notes in - INSTALL_Windows.txt before starting below procedures.

-
-

Preconditions

-
-

1. 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 zip files on the command line, you should

- - -
- -

Section I: Building and testing HDF5 with Microsoft Visual C++ 6.0 and Compaq Visual Fortran 6.0.

- -
- -

1. Extra Preconditions:

- - - + +

2. Currently, we support:

+ + + +

3. Please read CAREFULLY about HDF5 build +and install preconditions and notes in INSTALL_Windows.txt +before starting below procedures.

+ +
+

Section I: Building and testing HDF5 with Microsoft Visual +C++ 6.0 and Compaq Visual Fortran 6.0.

+ +
+

1. Preconditions:

+ + +

2. Building and testing HDF5 libraries and tools

-

We provide 2 options for users to build test HDF5 libraries and tools.

- - + + + diff --git a/release_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/INSTALL_Windows_From_Command_Line.txt index 0b04f37..10e33cc 100755 --- a/release_docs/INSTALL_Windows_From_Command_Line.txt +++ b/release_docs/INSTALL_Windows_From_Command_Line.txt @@ -41,42 +41,13 @@ WARNINGS: Please read CAREFULLY about HDF5 build and install preconditions and notes in INSTALL_Windows.txt before starting below procedures. -======================================================================== - Preconditions -======================================================================== - - 1. 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 zip files on the command line, - you should - - 1.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. - - 1.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". - - 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. ======================================================================== -1. Extra Preconditions: +1. Preconditions: 1.1 Set path for Visual C++ 6.0 and Compaq Visual Fortran 6.0 @@ -449,4 +420,4 @@ SECTION II: Building and testing HDF5 C and C++ Library on command line *********************************************************************** For further information, please refer to INSTALL_WINDOWS.txt. -Please send email to hdfhelp@ncsa.uiuc.edu for further assistance. +Please send email to help@hdfgroup.org for further assistance. diff --git a/release_docs/INSTALL_Windows_Short_INTEL.TXT b/release_docs/INSTALL_Windows_Short_INTEL.TXT index 642e23f..df51873 100755 --- a/release_docs/INSTALL_Windows_Short_INTEL.TXT +++ b/release_docs/INSTALL_Windows_Short_INTEL.TXT @@ -68,7 +68,7 @@ WARNINGS: Section II, STEP 2 Testing HDF5 libraries and tools. 7. For .Net and Intel users, If you are not building HDF5 with - Thread-Safe Feature, ttsafedll.dsp should be turned off always. + Thread-Safe Feature, ttsafedll.dsp should always be turned off. ======================================================================== Part I. INTEL compiler 7.1 with MSVS 6.0 @@ -300,5 +300,5 @@ WARNINGS: *********************************************************************** -Please send email to hdfhelp@ncsa.uiuc.edu for further assistance. +Please send email to help@hdfgroup.org for further assistance. diff --git a/release_docs/INSTALL_Windows_Short_Intel.htm b/release_docs/INSTALL_Windows_Short_Intel.htm index 293d330..72f25fe 100755 --- a/release_docs/INSTALL_Windows_Short_Intel.htm +++ b/release_docs/INSTALL_Windows_Short_Intel.htm @@ -1,468 +1,639 @@ - - - - - - -HDF5 Build and Install Instructions for Windows XP with -INTEL Compiler - - - + + + + + + + + +

HDF5 Build and Install Instructions for Windows XP with INTEL +Compiler

-

HDF5 Build and Install Instructions for Windows XP with INTEL Compiler

(Short Version)

-
+ +

Notes:

-

1. This short instruction is written for users who want to quickly build HDF5 -library and tools from the HDF5 source code package with Intel Compiler 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. -

+ +

1. This short instruction is written for users who want to +quickly build HDF5 library and tools from the HDF5 source code package +with Intel Compiler 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.

+

2. For Intel Compiler users, Intel 7.x works with MSVS 6.0 and - Intel 8.1 only works with MSVS .net 2003 when you build - HDF5-1.8.x.

- -

3. HDF5 Fortran DLL Libraries is not supported with Intel Fortran - 8.1 integration with Visual C++ .Net 2003 Environment. But - Release version of HDF5 Fortran DLL Libraries works with Intel - Fortran whilt Debug version doesn't.

- -

4. Szip library is different when using Intel compiler. - You should build Szip source codes with Intel - compiler or download binaries for Intel compiler - from - ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.

- -

5. Set up path for external libraries and headers -

-

- -

6. Part II, 2.1 in this document will build ONLY HDF5 Static and DLL C and C++ - Library using Intel C++ Compiler. If you want to build HDF5 - Static and DLL C and C++ Library as well as HDF5 Static Fortran - Library, Please go to Part II, 2.2 directly!

- -

7. Only short information was given on test HDF5 Libraries. Users - want to know detailed information about testing HDF5 Libraries - and tools, please refer to document - - INSTALL_Windows.html, Section II, STEP 2 Testing HDF5 libraries and tools.

- -

8. If  you are not building HDF5 with Thread-Safe Feature, ttsafedll.dsp -should be turned off always.

- +Intel 8.1 only works with MSVS .net 2003 when you build HDF5-1.8.x.

+ +

3. HDF5 Fortran DLL Libraries is not supported with Intel +Fortran 8.1 integration with Visual C++ .Net 2003 Environment. But +Release version of HDF5 Fortran DLL Libraries works with Intel Fortran +whilt Debug version doesn't.

+ +

4. Szip library is different when using Intel compiler. You +should build Szip source codes with Intel compiler or download binaries +for Intel compiler from +ftp://ftp.ncsa.uiuc.edu/HDF/szip/2.0/bin/windows.

+ +

5. Set up path for external libraries and headers

+ + + +

+ +

6. Part +II, 2.1 in this document will build ONLY HDF5 Static and DLL +C and C++ Library using Intel C++ Compiler. If you want to build HDF5 +Static and DLL C and C++ Library as well as HDF5 Static Fortran +Library, Please go to Part +II, 2.2 directly!

+ +

7. Only short information was given on test HDF5 Libraries. +Users want to know detailed information about testing HDF5 Libraries +and tools, please refer to document INSTALL_Windows.html, Section II, STEP 2 +Testing HDF5 libraries and tools.

+ +

8. If  you are not building HDF5 with Thread-Safe +Feature, ttsafedll.dsp should always be turned off.

+

Warnings:

-

Please read CAREFULLY about -HDF5 build and install preconditions and notes in + +

Please read CAREFULLY about +HDF5 build and install preconditions and notes in INSTALL_Windows.txt before starting below procedures.

-
+ +

Part I. Building HDF5 with INTEL compiler 7.1 with MSVS 6.0

-
- - - -
-

Part II. Building HDF5 with INTEL compiler 8.1 with Visual C++ .Net 2003 Environment

-
- - -
-

Part III Build HDF5 C and C++ Library with Intel C++ Compiler

-
- - -
+ +
+ + +
+

Part II. Building HDF5 with INTEL compiler 8.1 with Visual +C++ .Net 2003 Environment

+ +
+ + +
+

Part III Build HDF5 C and C++ Library with Intel C++ Compiler

+ +
+ + +

Part IV: 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.

-
+

Part V: Building HDF5 Examples (Optional)

-
-

Please read section II, step 4 in INSTALL_Windows.html.

-
+
+

Please read section II, step 4 in INSTALL_Windows.html.

+ +
+

Need further assistance? email to help@hdfgroup.org +or go to http://hdfgroup.org/windows/questions/questions.html +to get help on windows

+ +

Thank  +you  for  using  Hierarchical  +Data  Format  (HDF)

+ +

 

- - -

Need further assistance? email to hdfhelp@ncsa.uiuc.edu or go to - http://hdf.ncsa.uiuc.edu/windows/questions to get help on windows

-

Thank  you  for  using  Hierarchical  Data  Format  (HDF)

-

 

 

- +

 

+

 

- - \ No newline at end of file + + diff --git a/release_docs/INSTALL_Windows_Short_MSVS6.0.TXT b/release_docs/INSTALL_Windows_Short_MSVS6.0.TXT index 464b519..bf2808f 100755 --- a/release_docs/INSTALL_Windows_Short_MSVS6.0.TXT +++ b/release_docs/INSTALL_Windows_Short_MSVS6.0.TXT @@ -143,4 +143,4 @@ Please read section II, step 4 in INSTALL_Windows.txt. ************************************************************************ -Please send email to hdfhelp@ncsa.uiuc.edu for further assistance +Please send email to help@hdfgroup.org for further assistance diff --git a/release_docs/INSTALL_Windows_Short_MSVS6.0.htm b/release_docs/INSTALL_Windows_Short_MSVS6.0.htm index 5f49727..d9a38d8 100755 --- a/release_docs/INSTALL_Windows_Short_MSVS6.0.htm +++ b/release_docs/INSTALL_Windows_Short_MSVS6.0.htm @@ -1,309 +1,420 @@ - - - - - - -HDF5 Build and Install Instructions for Windows XP with MSVS 6.0 - + + - - - -

HDF5 Build and Install Instructions for Windows XP with MSVS 6.0

+ + +

HDF5 Build and Install Instructions for Windows XP with MSVS +6.0

+

(Short Version)

-
+

Notes:

-

This short instruction is written for users who want to quickly + +

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 6.0 but do not want to know HDF5 -building and installation details on Windows XP. +with Microsoft Visual Studio 6.0 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 + +

For detailed HDF5 build and install information, or if you +have trouble following any steps in the instructions, please refer to INSTALL_Windows.html for further information.

-

For users who would like to build and test HDF5 package from the + +

For users who would like to build and test HDF5 package from +the command line, please refer to INSATLL_Windows_From_Command_Line.html.

-

Warnings: Please read CAREFULLY about HDF5 build and install preconditions and -notes in INSTALL_Windows.html before starting below procedures.

-
+ +

Warnings: Please read CAREFULLY about HDF5 +build and install preconditions and notes in INSTALL_Windows.html +before starting below procedures.

+ +

STEP 1: Building HDF5 Libraries and Tools

-
- - -

 

+
+

Please read section II, step 4 in INSTALL_Windows.html. +

+
+

Need further assistance? email to help@hdfgroup.org +or go to http://hdfgroup.org/windows/questions.html +to get help on windows

+

Thank  +you  for  using  Hierarchical  +Data  Format  (HDF)

+

 

- +

 

+

 

- - + + diff --git a/release_docs/INSTALL_Windows_Short_NET.TXT b/release_docs/INSTALL_Windows_Short_NET.TXT index b95334e..b5d3078 100755 --- a/release_docs/INSTALL_Windows_Short_NET.TXT +++ b/release_docs/INSTALL_Windows_Short_NET.TXT @@ -17,7 +17,7 @@ Notes: This short instruction is written for users who want to quickly INSATLL_Windows_From_Command_Line.txt. For .Net and Intel users, If you are not building HDF5 with - Thread-Safe Feature, ttsafedll.dsp should be turned off always. + Thread-Safe Feature, ttsafedll.dsp should always be turned off. WARNINGS: @@ -74,6 +74,9 @@ notes in INSTALL_Windows.txt before starting below procedures. copy the nessary files to the directory where they will be used. 2. Open all.dsw workspace + + In the pop up window, choose "Yes To All" to convert all project + files to Visual C++ .Net project format. Notes: all.sln is for command use only. Please open all.dsw not all.sln. @@ -251,5 +254,5 @@ the following part in INSTALL_Windows.txt for detailed information. ************************************************************************ -Need further assistance, send email to hdfhelp@ncsa.uiuc.edu +Need further assistance, send email to help@hdfgroup.org diff --git a/release_docs/INSTALL_Windows_Short_Net.htm b/release_docs/INSTALL_Windows_Short_Net.htm index 2831eb0..690ce36 100755 --- a/release_docs/INSTALL_Windows_Short_Net.htm +++ b/release_docs/INSTALL_Windows_Short_Net.htm @@ -1,358 +1,787 @@ - - - - - - -HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003 - + + + + + + +

HDF5 Build and Install Instructions for Windows XP with MSVS +.NET 2003

+ - - - -

HDF5 Build and Install Instructions for Windows XP with MSVS .NET 2003

(Short Version)

-
+ + +

Notes:

-

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

-

2. For detailed HDF5 build and install information, or if you have - trouble following any steps in the instructions, please refer to - INSTALL_Windows.html for further information.

-

3. For users who would like to build and test HDF5 package from the - command line, please refer to - INSATLL_Windows_From_Command_Line.txt.

-

4. For .Net and Intel users, If  you are not in building HDF5 with - Thread-Safe Feature, ttsafedll.dsp should be turned off always.

-

Warnings: Please read CAREFULLY about -HDF5 build and install preconditions and notes before starting below procedures.

- -
+ +

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

+ + +

2. For detailed HDF5 build and install information, or if you +have trouble following any steps in the instructions, please refer to +INSTALL_Windows.html for further information.

+ + +

3. For users who would like to build and test HDF5 package +from the command line, please refer to +INSATLL_Windows_From_Command_Line.txt.

+ + +

4. For .Net and Intel users, If  you are not in +building HDF5 with Thread-Safe Feature, ttsafedll.dsp should always be turned +off.

+ + +

Warnings: Please read CAREFULLY about +HDF5 build and install preconditions and notes before +starting below procedures.

+ + +

Preconditions:

-
+ +

a. Setup path Visual Studio .Net 2003 Compiler.

-

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

-

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. Read Section V in INSTALL_WINDOWS.html. -

-

You have to read this part even if you want to only use Zlib - or Szip. You also need to read Section V in INSTALL_WINDOWS.html .

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.

-
+ + +

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

+ + +

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. Read Section V in INSTALL_WINDOWS.html. +

+ + +

You have to read this part even if you want to only use Zlib +or Szip. You also need to read Section V in INSTALL_WINDOWS.html +.

+ + +

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.

+ + +

STEP 1: Building HDF5 Libraries and Tools

-
-

1. Open all.dsw workspace

Notes:

Notes: all.sln is for command use only. Please open all.dsw not all.sln.

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.

+ + +
+

STEP 2: 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:

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
OptionsIllustration
+ +

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 into file:

+ + + +

Check check_results.txt and there should be no failures at all.

-

If you want to test HDF5 libraries and tools one by one, please refer to - Section II, step 2 in INSTALL_Windows.html.

-
+ + +

If you want to test HDF5 libraries and tools one by one, +please refer to Section II, step 2 in INSTALL_Windows.html.

+ + +
+

Check check_results.txt and there should be no failures at all.

+ + +

If you want to test HDF5 libraries and tools one by one, +please refer to Section II, step 2 in INSTALL_Windows.html.

+ + +

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.

-
+ +
+

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

- - - -
-

Need further assistance? email to -hdfhelp@ncsa.uiuc.edu or go to - http://hdf.ncsa.uiuc.edu/windows/questions to get help on windows

-

Thank  you  for  using  Hierarchical  Data  Format  (HDF)

-

 

+ + +
+

Please read section II, step 4 in INSTALL_Windows.html.

+ + +
+

Need further assistance? email to help@hdfgroup.org +or go to http://hdfgroup.org/windows/questions.html +to get help on windows

+ + +

Thank  +you  for  using  Hierarchical  +Data  Format  (HDF)

+ +

 

- + +

 

- +

 

- - \ No newline at end of file + + -- cgit v0.12