summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAllen Byrne <byrn@hdfgroup.org>2015-11-18 20:26:11 (GMT)
committerAllen Byrne <byrn@hdfgroup.org>2015-11-18 20:26:11 (GMT)
commit2e9220b8e6ab08209e512f6eb6ad3abec0d9202c (patch)
treec8b3fc63e20036e6d2e931d545651c5ac24fd2a8
parent9de281111fa3554299b3edd57937d3817dba676f (diff)
downloadhdf5-2e9220b8e6ab08209e512f6eb6ad3abec0d9202c.zip
hdf5-2e9220b8e6ab08209e512f6eb6ad3abec0d9202c.tar.gz
hdf5-2e9220b8e6ab08209e512f6eb6ad3abec0d9202c.tar.bz2
[svn-r28397] Add note about the "H5_BUILT_AS_DYNAMIC_LIB" compile definition
-rw-r--r--release_docs/INSTALL_Windows.txt6
-rw-r--r--release_docs/USING_HDF5_VS.txt43
2 files changed, 27 insertions, 22 deletions
diff --git a/release_docs/INSTALL_Windows.txt b/release_docs/INSTALL_Windows.txt
index 7873709..7af2571 100644
--- a/release_docs/INSTALL_Windows.txt
+++ b/release_docs/INSTALL_Windows.txt
@@ -9,8 +9,10 @@ We now recommend that users build, test and install HDF5 using CMake.
Instructions for building and testing HDF5 using CMake can be found in the
INSTALL_CMake.txt file found in this folder.
-For instructions of building and testing an application with HDF5, see
+For instructions of building and testing an application with HDF5, see
USING_HDF5_CMake.txt file found in this folder.
Users who want to build and run an application with HDF5 in Visual Studio
-without using CMake should consult the USING_HDF5_VS.txt file.
+without using CMake should consult the USING_HDF5_VS.txt file. Building
+applications with the dynamic/shared hdf5 libraries requires that the
+"H5_BUILT_AS_DYNAMIC_LIB" compile definition be used.
diff --git a/release_docs/USING_HDF5_VS.txt b/release_docs/USING_HDF5_VS.txt
index 9063ea6..146782a 100644
--- a/release_docs/USING_HDF5_VS.txt
+++ b/release_docs/USING_HDF5_VS.txt
@@ -6,29 +6,32 @@
These suggestions are for Visual Studio users.
-Instructions for building and testing HDF5 applications using CMake can
+Instructions for building and testing HDF5 applications using CMake can
be found in the USING_HDF5_CMake.txt file found in this folder.
-The following two sections are helpful if you do not use CMake to build
+NOTE: Building applications with the dynamic/shared hdf5 libraries requires
+ that the "H5_BUILT_AS_DYNAMIC_LIB" compile definition be used.
+
+The following two sections are helpful if you do not use CMake to build
your applications.
-
+
========================================================================
Using Visual Studio 2010 with HDF5 Libraries built with Visual Studio 2010
========================================================================
1. Set up path for external libraries and headers
- The path settings will need to be in the project property sheets per project.
- Go to "Project" and select "Properties", find "Configuration Properties",
+ The path settings will need to be in the project property sheets per project.
+ Go to "Project" and select "Properties", find "Configuration Properties",
and then "VC++ Directories".
-
+
1.1 If you are building on 64-bit Windows, find the "Platform" dropdown
and select "x64".
-
+
1.2 Add the header path to the "Include Directories" setting.
-
+
1.3 Add the library path to the "Library Directories" setting.
-
+
1.4 Select Linker->Input and beginning with the
"Additional Dependencies" line, enter the library names. The
external libraries should be listed first, followed by the HDF5
@@ -37,30 +40,30 @@ Using Visual Studio 2010 with HDF5 Libraries built with Visual Studio 2010
szip.lib zlib.lib hdf5.lib hdf5_cpp.lib
-
+
==========================================================================
Using Visual Studio 2008 with HDF5 Libraries built with Visual Studio 2008
==========================================================================
2. Set up the path for external libraries and headers
- Invoke Microsoft Visual Studio and go to "Tools" and select "Options",
+ Invoke Microsoft Visual Studio and go to "Tools" and select "Options",
find "Projects", and then "VC++ Directories".
-
+
2.1 If you are building on 64-bit Windows, find the "Platform" dropdown
and select "x64".
- 2.2 Find the box "Show directories for", choose "Include files", add the
+ 2.2 Find the box "Show directories for", choose "Include files", add the
header path (i.e. c:\Program Files\HDF_Group\HDF5\1.8.x\include)
to the included directories.
2.3 Find the box "Show directories for", choose "Library files", add the
library path (i.e. c:\Program Files\HDF_Group\HDF5\1.8.x\lib)
to the library directories.
-
+
2.4 If using Fortran libraries, you will also need to setup the path
for the Intel Fortran compiler.
-
+
2.5 Select Project->Properties->Linker->Input and beginning with the
"Additional Dependencies" line, enter the library names. The
external libraries should be listed first, followed by the HDF5
@@ -74,15 +77,15 @@ Using Visual Studio 2008 with HDF5 Libraries built with Visual Studio 2008
========================================================================
3.1 FAQ
-
+
Many other common questions and hints are located online and being updated
in the HDF5 FAQ. For Windows-specific questions, please see:
-
+
http://www.hdfgroup.org/HDF5/faq/windows.html
-
+
For all other general questions, you can look in the general FAQ:
-
+
http://hdfgroup.org/HDF5-FAQ.html
-
+
************************************************************************
Please send email to help@hdfgroup.org for further assistance.