diff options
Diffstat (limited to 'release_docs/INSTALL_Windows.txt')
-rw-r--r-- | release_docs/INSTALL_Windows.txt | 96 |
1 files changed, 70 insertions, 26 deletions
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt index 703d2a8..daedadd 100644 --- a/release_docs/INSTALL_Windows.txt +++ b/release_docs/INSTALL_Windows.txt @@ -1,6 +1,6 @@ *********************************************************************** -* HDF5 Build and Install Instructions for Windows XP * +* HDF5 Build and Install Instructions for Windows XP/VISTA * * (Full Version) * *********************************************************************** @@ -16,13 +16,15 @@ Contents: 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 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 with Fortran Support Section VII : How to build Multi-threaded version of HDF5 library Section VIII : How to build HDF5 with Thread-Safe Feature Section IX : How to build HDF5 for 64-bit Windows - Section X : Misc. + Section X : How to build HDF5 on Windows Vista + Section XI : Backwards Compatibility with HDF5 1.6 + Section XII : Misc. ======================================================================== @@ -108,7 +110,7 @@ Preconditions: Variables" box. In the New Variable window, set "Variable name" as HDF5_EXT_ZLIB and - "Variable value" as zdll.lib, then click OK. + "Variable value" as zlib1.lib, then click OK. Similarly, you can set: @@ -151,13 +153,11 @@ Notes: directory, run copy_hdf.bat first and then open all.dsw under hdf5/windows/proj/all to start building process. - 2. Users who prefer to use Visual Studio 6.0 can follow instructions in - INSTALL_Windows_Short_MSVS6.0.txt. Note, however, that Visual Studio - 6.0 will not be supported in future versions of HDF5. + 2. Visual Studio 6.0 will not be supported in HDF5 1.8 or later release. 2. Users who prefer to use Visual Studio .NET can follow instructions in - INSTALL_Windows_Short_Net.txt. Note, however, that Visual Studio - .NET will not be supported in future versions of HDF5. + INSTALL_Windows_Short_Net.txt. Note, however, HDF5 Fortran product + will not be supported in HDF5 1.8 release. 3. For users who want to quickly build HDF5 library or do not want to know HDF5 building and installation details, please read the @@ -176,9 +176,6 @@ Notes: 7. For users who would like to build Muti-threaded version of HDF5 library, please read Section VII. - - 8. For users who would like to build, test and use HDF5 snapshot - release, please read Section VIII. ======================================================================== @@ -1372,7 +1369,7 @@ Notes: In Visual Studio 2005, the Single-threaded runtime libraries have been those two sections carefully before go to the following part. -In Visual Studio 6.0 and .Net, users have the option of building multi-threaded +In Visual Studio.Net, users have the option of building multi-threaded libraries by manipulating the project settings. Otherwise, the build process is very much the same. Therefore, follow the instructions below, and refer to the earlier sections of this document for details on building and testing. @@ -1648,10 +1645,67 @@ Installing: into one folder, hdf5lib. This script should work identically on 32- and 64-bit builds. Therefore, you may follow the instructions in Section II about installing. - - + ======================================================================== - Section X: Misc. + Section X: How to build HDF5 on Windows Vista +======================================================================== +Building on Windows Vista is very similar to building on Windows XP, with +some minor changes. Therefore, follow the build instructions above, with the +following considerations: + + 1. Only Visual Studio 2005 is currently supported on Windows Vista. This + is because Microsoft has ended their support for 6.0 and .NET. + + 2. Building Fortran libraries has not been tested, and is therefore also + unsupported. You may attempt to build Fortran libraries following the + instructions above, but they should be considered experimental and used + for testing only. + + 3. Elevated security permissions are required to test the HDF5 libraries. + This is because DLLs are installed in the system directory. To enable + elevated security: + + 1. In the Start menu, search for "Command Prompt". Right click on + the "Command Prompt" program, and select "Run as administrator." + + 2. A security dialog will pop up. Make sure you select "Continue." + + 3. Test HDF5 libraries and tools as usual using "hdf5check.bat" + script. + + +======================================================================== + Section XII: Backwards Compatibility with HDF5 1.6 +======================================================================== + +Several basic HDF5 functions have changed over the years as requirements on +the library and data format have evolved. To enable existing applications to +run properly, all versions of these functions have been retained; for +flexibility and ease-of-use, macros have been created that can be mapped +either globally to broad sets of function versions or on a +function-by-function basis to specific versions. For example, an overall +approach can be determined by means global setting; function-level settings +can then be used to override the global setting then for specific functions. + +To enable 1.6 API symbols in your application: + + 1. Build and test HDF5 normally (see Section II). + + 2. Open your application in Visual Studio. Right click on the + project file, and select properties. + + 3. Select the C/C++ > Preprocessor pane on the left. In the list of + "Preprocessor Definitions", add "H5_USE_16_API". (Note: macros in + the list are separated by a semi-colon.) + + 4. Repeat this for each project and project configuration that uses + HDF5 libraries. + + 5. Continue to build and test your application normally. + + +======================================================================== + Section XII: Misc. ======================================================================== 1. Helpful Pointers @@ -1679,15 +1733,5 @@ using the Visual C++ Development Environment. Developer Studio project settings dialog. -2. Backward compatibility with 1.6 - If you are going to use 1.6 APIs with 1.8 branch, you may do the - following two things: - 3.1 Uncomment out /*#define H5_WANT_H5_V1_6_COMPAT 1*/ inside - h5pubconf.h under windows\src. - 3.2 Set up an environment variable H5_WANT_H5_V1_6_COMPAT to 1, - this will be used to test compatibility of error APIs. - 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 help@hdfgroup.org for further assistance. |