diff options
author | Dana Robinson <derobins@hdfgroup.org> | 2012-10-23 18:27:33 (GMT) |
---|---|---|
committer | Dana Robinson <derobins@hdfgroup.org> | 2012-10-23 18:27:33 (GMT) |
commit | 88885a82aed548e2847f8e98a55eeeb53779328d (patch) | |
tree | 4f8a86821ec328ef9d9ea7146cf28d2c63a411e9 /release_docs | |
parent | e96bb5fed1ce5da8df8e63561aeec7497a68cb4b (diff) | |
download | hdf5-88885a82aed548e2847f8e98a55eeeb53779328d.zip hdf5-88885a82aed548e2847f8e98a55eeeb53779328d.tar.gz hdf5-88885a82aed548e2847f8e98a55eeeb53779328d.tar.bz2 |
[svn-r22953] Purpose:
Removed legacy Visual Studio solutions and projects, which will
no longer be supported after HDF5 1.8.10.
Diffstat (limited to 'release_docs')
-rw-r--r-- | release_docs/obsolete_windows_docs/INSTALL_Windows_From_Command_Line.txt | 166 | ||||
-rw-r--r-- | release_docs/obsolete_windows_docs/INSTALL_Windows_Short_VS2008.TXT | 201 |
2 files changed, 0 insertions, 367 deletions
diff --git a/release_docs/obsolete_windows_docs/INSTALL_Windows_From_Command_Line.txt b/release_docs/obsolete_windows_docs/INSTALL_Windows_From_Command_Line.txt deleted file mode 100644 index bbb7762..0000000 --- a/release_docs/obsolete_windows_docs/INSTALL_Windows_From_Command_Line.txt +++ /dev/null @@ -1,166 +0,0 @@ -************************************************************************ -* Instructions for Building and Testing HDF5 on Windows XP * -* (From Command Line) * -************************************************************************ -Note: This instruction is written for users who would like to build HDF5 - libraries and tools from the HDF5 source code package on command - line. We no longer support building HDF5 using Microsoft Visual - Studio .NET 2003 or Visual Studio VS2005 or Intel Fortran 91. - - Currently, we support: - - 1. Building and testing HDF5 C/C++/Fortran libraries on command line with - Microsoft Visual Studio 2008 for 32- or 64-bit Windows. - - 2. Building and testing HDF5 C/C++/Fortran libraries and utilities using - CMake tools. Refer to the CMAKE.txt file for detailed information. - - For all other Windows development tools, HDF5 should be built in - the development environment. Please refer to INSTALL_Windows.txt - for detailed HDF5 building and installation information, or - INSTALL_Windows_Short_VS2008.txt for quick HDF5 building and installation - instructions. - -WARNINGS: - -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 on command line with Microsoft - Visual Studio -======================================================================== - -1. Preconditions: - - 1.1 Verify environment for Visual Studio - - Building from the command line requires environment variables for Visual - Studio. These are generally setup when Visual Studio is installed, but you - can verify by running the command: - - echo %vs90comntools% - - This should output a path similar to: - - C:\Program Files\Microsoft Visual Studio 9\Common7\Tools\ - - 1.2 Run batch file copy_hdf.bat. - - Go to c:\MyHDFstuff\hdf5\windows and run copy_hdf.bat. - - 1.3 Setup evironment for external libraries - - Similarly to building from within Visual Studio, HDF5 requires environment - variables for szip and zlib library names. To define these environment - variables: - - From the command prompt that you will be building HDF5 from, issue the - following command: - - set HDF5_EXT_ZLIB=zlib1.lib - - replacing "zlib1.lib" with the name of the zlib library on your system. - Similarly, set HDF5_EXT_SZIP to the name of the szip library on your system. - - (Optional) If you will be building using the /useenv switch, you must also - define variables INCLUDE and LIB with a semi-colon deliminated list of - paths for szip and zlib include files and libraries, respectively. Set - these variables in the same way you set HDF5_EXT_ZLIB and HDF5_EXT_SZIP. - - -2. Building and testing HDF5 libraries and tools - - We provide 2 options for users to build and test HDF5 libraries - and tools. - - 2.1 Options A: Build and test in one step - - A batch file named hdf5bt.bat in c:\MyHDFstuff\hdf5 directory is - provided for users to build and test HDF5 library and tools together - from command line. - - hdf5bt file takes the following options: - /vs9 Build HDF5 using Visual Studio 2008 - /fort Build and test HDF5 with Fortran libraries - /ivf101 Build HDF5 Fortran using Intel Visual Fortran 10.1 - /useenv Build HDF5 using compiler settings defined - in the environment, rather than the IDE. - /? Help information - - If you specify the "/useenv" option, then include and library - directories for szip and zlib must have been set in the - Preconditions above. - - Invoke a command prompt window and run hdf5bt. Users are - encouraged to pipe the test output into a file. You should find no - compilation errors or "*FAILED*" marks. - - 2.2 Options B: Build and test in two steps - - We also provide users with the option to build and test HDF5 libraries - and tools seperately. - - Step 1) Build HDF5 Libraries and Tools - - A batch file named hdf5build.bat in c:\MyHDFstuff\hdf5 - directory is provided for users to build HDF5 library and - tools from command line. - - hdf5build takes the following options: - /vs9 Build HDF5 using Visual Studio 2008 - /fort Build HDF5 with Fortran libraries - /ivf101 Build HDF5 Fortran using Intel Visual Fortran 10.1 - /nodebug Build HDF5 release versions only - Note: Default is to build debug and release versions - /useenv Build HDF5 using compiler settings defined - in the environment, rather than the IDE. - /? Help information - - If you specify the "/useenv" option, then include and library - directories for szip and zlib must have been set in the - Preconditions above. - - Invoke a command prompt window and run hdf5build. Users are - encouraged to pipe the test output into a file. You can check - the file to find out whether there are any compilation errors. - - Step 2) Test HDF5 Libraries and Tools - - 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: - - 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. To use this option, HDF5 - Fortran libraries must have been built. - - hdf5check enableall Test HDF5 C/Fortran libraries and - tools. To use this option, HDF5 - Fortran libraries must have been built. - - nodebug option can be added to any of the above options to only - test the release versions. - - Invoke a command prompt window and run hdf5check with appropriate - option. Users are encouraged to pipe the test output into a file. - You should find no "*FAILED*" marks. - -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. - -For further information, please refer to INSTALL_WINDOWS.txt. - - -*********************************************************************** -For further information, please refer to INSTALL_WINDOWS.txt. - -Please send email to help@hdfgroup.org for further assistance. diff --git a/release_docs/obsolete_windows_docs/INSTALL_Windows_Short_VS2008.TXT b/release_docs/obsolete_windows_docs/INSTALL_Windows_Short_VS2008.TXT deleted file mode 100644 index 4ec79ed..0000000 --- a/release_docs/obsolete_windows_docs/INSTALL_Windows_Short_VS2008.TXT +++ /dev/null @@ -1,201 +0,0 @@ -************************************************************************ -* Build and Install HDF5 C/C++ Library with Visual Studio 2008 * -* with Windows XP (Short Version) * -************************************************************************ - -Notes: 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 2008 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 INSTALL_Windows_From_Command_Line.txt. - - Notes: - - 1. HDF5 1.8 can also be built using Visual Studio 2008 on Windows - Vista. For details, please see Section X of INSTALL_Windows.txt. - - 2. 64-bit builds are also supported in Visual Studio 2008. For details - please see Section IX of INSTALL_Windows.txt. - - 3. Fortran libraries can be built with Visual Studio 2008 and Intel - Fortran 10.1. For details, see Section VI of INSTALL_Windows.txt. - -WARNINGS: - -Please read CAREFULLY about HDF5 build and install preconditions and -notes in INSTALL_Windows.txt before starting below procedures. - - -======================================================================== - Preconditions -======================================================================== - - 1. 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 in INSTALL_Windows.txt. - - 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.txt. - - Invoke Microsoft Visual Studio and go to "Tools" and select "Options". In - the left pane of "Option" window poped up, choose and expand "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:\zlib125\include, c:\szip\include) - from the directory list, add the header path (c:\zlib125\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:\zlib125\dll, - c:\szip\dll) from the directory list, add the library path - (c:\zlib125\dll, c:\szip\dll) to the library directories. - - NOTE: - If you are using VS2010, the path settings will need to be in project - property sheets per project. Go to "Project" and select "Properties", find - "Configuration Properties", and then "VC++ Directories". - - Add the header path to the "Include Directories" setting. - - Add the library path to the "Library Directories" setting. - -======================================================================== - Building HDF5 C/C++ Libraries with Visual Studio 2008 -======================================================================== - - 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 source codes and - text files saved under c:\MyHDFstuff\hdf5\windows directory to the - corresponding directories under hdf5. - - 2. Invoke Microsoft Visual Studio compiler - - Invoke Microsoft Visual Studio. From the main menu, go to "File" and - select the "Open Solution" option. Then open the - c:\MyHDFstuff\hdf5\windows\proj\all\all.sln solution if you are building - without Fortran libraries, or - c:\MyHDFstuff\hdf5\windows\proj\all_fortran\all_fortran.sln if you would - like to use Fortran. - - You should find Windows project files listed as "all", "big", etc. on the - left. - - - 3. (Optional) Disable HDF5 C++ and High level C++ - - In HDF5 1.8, C++ and HL C++ libraries are built by default. To opt-out, - you must explicitly disable them. - - 3.1 Skip this step if you do want to build HDF5 High-Level C++ libraries - - Go to "Project" and select "Project Dependencies". Select "all", and - disable all of the following projects: - - hdf5_hl_cpp - hdf5_hl_cppdll - hl_test_table_cpp - hl_test_table_cppdll - - 3.2 Skip this step if you do want to build HDF5 High-Level libraries - - Go to "Project" and select "Project Dependencies". Select "all", and - disable all of the project files listed in the previous step, as well - as the following projects: - - hdf5_hl - hdf5_hldll - hl_test_image - hl_test_imagedll - hl_test_lite - hl_test_litedll - hl_test_table - hl_test_tabledll - hl_test_ds - hl_test_dsdll - hl_test_packet - hl_test_packetdll - - Click on "OK", From the main menu, choose "Build"-> "Build" or - "Rebuild ALL" to build both release and debug version of HDF5 - Libraries. - - - 4. Select "Build", then Select "Configuration Manager". - - 4.1 To build debug static libraries, debug multithreaded DLLs, and tests: - - In "Active Solution Configuration", select "Debug". Select "Close". - Select "Build" -> "Build Solution" or "Rebuild Solution" to build debug - version of project "all". - - 4.2 To build release static libraries, multithreaded DLLs and tests: - - In "Active Solution Configuration", select "Release". Select "Close". - Select "Build" -> "Build Solution" or "Rebuild Solution" to build release - version of project "all". - - Both debug and release versions must be built. - - Warning messages can be ignored. - -======================================================================== - Testing HDF5 C/C++ Libraries -======================================================================== - -HDF5 libraries and tools should be tested to make sure that they were -built correctly. c:\MyHDFstuff\hdf5\hdf5check.bat was provided to test -HDF5 libraries and tools. - -hdf5check.bat has four options: - - 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 - - nodebug -- can be added to any of the above to not - test debug versions - -Notes: Users who only build HDF5 C/C++ libraries ONLY have the first - two options. - -Invoke a command prompt window and run hdf5check with appropriate option. -Users are encouraged to pipe the test output into a file. You should find -no "*FAILED*" marks. - -If you want to test HDF5 libraries and tools one by one, please refer to -Section II, step 2 in INSTALL_Windows.txt. - - -======================================================================== - Installing HDF5 C/C++ Libraries -======================================================================== - -Run the batch file c:\MyHDFstuff\hdf5\installhdf5lib.bat to install -all HDF5 libraries and tools into c:\MyHDFstuff\hdf5\hdf5lib directory. - -======================================================================== - Building HDF5 Examples and Applications -======================================================================== - -Building HDF5 Examples is Optional. Please read Section II, step 4 and -the following part in INSTALL_Windows.txt for detailed information. - - - -************************************************************************ - -Need further assistance, send email to help@hdfgroup.org - |