[svn-r28397] Add note about the "H5_BUILT_AS_DYNAMIC_LIB" compile definition

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.