mirror/hdf5
2
0
Fork 0
mirror of https://github.com/HDFGroup/hdf5.git synced 2025-02-05 15:42:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

[svn-r13951] Purpose: Update Windows documentation

Browse Source 
Description:
Explain why Fortran isn't supported on MinGW and give users an "unsupported" alternative.  Also re-worked the main documentation to clarify using the HDF5 DLL libraries.

Tested:
None needed.
This commit is contained in:
Scott Wegner 2007-07-06 09:12:35 -05:00
parent e3966680ef
commit 625e2f5047
2 changed files with 102 additions and 121 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
release_docs/INSTALL_MinGW.txt
View File

@ -20,21 +20,19 @@ Preconditions:
gcc-3.4.2 is included in MinGW, which includes:
gcc : GNU C compiler
gcc-g++: GNU C++ compiler
gcc-g77: GNU Fortran 77 compiler
2.2 Using Compilers Not Supported
The compilers in 2.1 and 2.2 are supported and tested by HDF
group. Any other compilers may still work but they are not
The compilers in 2.1 are supported and tested by The HDF
Group. Any other compilers may still work but they are not
guaranteed by HDF group.
If users want to use other compilers except those in 2.1 and 2.2,
If users want to use other compilers except those in 2.1,
try to set the following variables to override the default
choices.
CXX : C++ compiler command
3. HDF5 Dependencies
3.1 Zlib
@ -127,7 +125,15 @@ Build HDF5 on MinGW
Therefore, each configuration must incude the parameter
"--disable-stream-vfd".
2) Building Fortran libraries is also currently unsupported.
2) Building Fortran libraries is also currently unsupported. This is
because the current release of gcc for mingw (3.4.5) is not compatible
with the current g95 for mingw (g95 0.91!, gcc version 4.0.3).
However, if you would like to build gcc 4.x on your own, there are
instructions for doing so here:
http://www.mingw.org/MinGWiki/index.php/How%20to%20Compile%20GCC%204.1
Remember that this is UNSUPPORTED, and any Fortran binaries build
should be considered experimental.
4) Shared libraries can not be built on MinGW in release 1.8.0.
@ -187,7 +193,7 @@ Build HDF5 on MinGW
example, if users want to configure HDF5 C/C++
library, with zlib library at /c/usr/, and
install HDF5 into directory /c/hdf5 using
gcc/g++ as C/C++ compiler and g95 as Fortran compiler:
gcc/g++ as C/C++ compiler:
$ ./configure
--with-zlib=/c/usr/include,/c/usr/lib

55
release_docs/INSTALL_Windows.txt
View File

@ -939,7 +939,6 @@ Waring: The instructions below will only describe how to build an application
version of the HDF5 library or DLL, you need to substitute the release
version of the HDF5 library or DLL with the debug version.
To use HDF5 static library
To build an application that uses the HDF5 static library the following
locations will need to be specified for locating header files and linking with
@ -1037,7 +1036,21 @@ To use HDF5 static library
hdf5_cppdll.lib for HDF5 C++ library, and hdf5_fortrandll.lib
for HDF5 Fortran library.
2. Place the DLL in a location that Windows will be able to locate. The
2. In the Project Properties dialog, go to the C/C++ > Preprocessor
subsection. In the "Preprocessor Definitions" box, add "_HDF5USEDLL_"
to the list.
3. (Optional) Also add HDF5CPP_USEDLL to use HDF5 C++ DLL.
4. (Optional) Also add _HDF5USEHLDLL_ to use HDF5 high level DLL.
5. (Optional) Also add HDF5USE_HLCPPDLL use HDF5 high level C++ DLL.
6. (Optional) Follow Project->Settings->Fortran->Category->General->
Predefined Preprocess or Symbols, and add "HDF5F90_WINDOWS" to use HDF5
Fortran DLL.
7. Place the DLLs in a location that Windows will be able to locate. The
searched path and order for DLL's is
a) The directory where the executable module for the current
@ -1941,44 +1954,6 @@ using the Visual C++ Development Environment.
Developer Studio project settings dialog.
1.3 DLL... hints:
If you want to use DLL versions of HDF5 library in your application,
you should
1) Put HDF5 DLL into Windows system directory
2) add HDF5 DLL export library into your project
3) Follow "Settings... details" into the last line:
change Single-Threaded into Multithreaded DLL or
Debug Multithreaded DLL
4) Follow "Settings.. details" into PreProcessor:
Project
Settings
C/C++
Category
PreProcessor
Find PreProcessor definations and Add _HDF5USEDLL_ at the
end of the PreProcessor definitions to use HDF5 C DLL.
5)(optional) repeat 4), add HDF5CPP_USEDLL at the
end of the PreProcessor definitions to use HDF5 C++ DLL.
6) (optional) repeat 4), add _HDF5USEHLDLL_ at the
end of the PreProcessor definitions to use HDF5 high level
DLL.
7) (optional) repeat 4), add HDF5USE_HLCPPDLL at the
end of the PreProcessor definitions to use HDF5 high level C++
DLL.
8) (optional) Follow Project->Settings->Fortran->Category->
General->Predefined Preprocess or Symbols, and add
"HDF5F90_WINDOWS" to use HDF5 Fortran DLL.
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: