From 7b50bea4c3af87f2f92af4fbe7e55245078fbdad Mon Sep 17 00:00:00 2001 From: Elena Pourmal Date: Thu, 10 Jan 2008 15:35:43 -0500 Subject: [svn-r14395] Maintenance: Updated installation instructions for VMS system. --- release_docs/INSTALL_VMS.txt | 110 ++++++++++++++++++------------------------- 1 file changed, 47 insertions(+), 63 deletions(-) diff --git a/release_docs/INSTALL_VMS.txt b/release_docs/INSTALL_VMS.txt index 5e31db6..97a3880 100644 --- a/release_docs/INSTALL_VMS.txt +++ b/release_docs/INSTALL_VMS.txt @@ -1,7 +1,6 @@ Building and installation instructions for Alpha Open VMS - This file is under construction - EIP June 1, 2006 - + HDF5 1.8.0 release + January 2008 @@ -9,83 +8,68 @@ -------- 1. Obtaining HDF5 - 2. Building C, Fortran and C++ libraries - 3. Testing HDF5 libraries and tools - 4. Installing HDF5 libraries - 5. Known problems + 2. Building and testing HDF5 C, Fortran and C++ libraries, + and utilties + 3. Installing HDF5 libraries + 4. Known problems 1.Obtaining HDF5 + Please see INSTALL file in this directory for downloading instructions. - 2. Building C, Fortran and C++ libraries + 2. Building and testing HDF5 C, Fortran and C++ libraries and utilties. - IMPORTANT: This version REQUIRES GNU ZLIB librarary to be installed + IMPORTANT: This version REQUIRES GNU ZLIB library to be installed on a system. You may download the source code from http://www.zlib.net/ - Use tar command to untar HDF5 source ball - tar -xvf hdf5-1.8.0-
.tar
-
-	 -  Change default directory to [.hdf5-1.8.0-
.vms]
-         -  Modify make.com file to point to the installed ZLIB library.
-         -  Run 
-		@make
-           command. This command file will build 
+		tar -xvf hdf5-1.8.0.tar
+
+	 -  Change default directory to [.hdf5-1.8.0.vms]
+         -  Edit make.com:
+         	specify path to ZLIB library
+        	if necessary, modify compilation flags 
+	    Do NOT REMOVE /define=H5_VMS and /standard=strict_ansi qualifiers.
+         -  Run build.com command file 
+		@build
+            We recommend to use batch queue to build and test this distribution. 
+            The command file runs make.com and builds 
 			C library, tests, and utilities	
 			Fortran library and tests
 			C++ library and tests
-			C, Fortran and C++ examples
-
-	   IMPORTANT: Compilations flags are defined in the [.vms]make.com file of the
-	   source tree. It is set up to use /float=float_ieee qualifier for C, Fortran 
-	   and C++ compilersi, and debug mode. If desired, those flags can be removed.
-	   Do NOT REMOVE /define=H5_VMS and /standard=strict_ansi qualifiers.
-	   If you have to use make.com file in a particular directory, make sure that
-	   you modify the compilation flags in this file appropriately.
-
-	   If  make.com succeeds, the following libraries and utilties will be built:
-
-	   [.src]hdf5.olb
-	   [.fortran.src]hdf5_fortran.olb
-	   [.c__.src]hdf5_cplus.olb
-	   [.tools.h5diff]h5diff.exe
-	   [.tools.h5dump]h5dump.exe
-	   [.tools.h5import]h5import.exe
-	   [.tools.h5jam]h5jam.exe
-	   [.tools.h5jam]h5unjam.exe
-	   [.tools.h5ls]h5ls.exe
-	   [.tools.h5repack]h5repack.exe
-
-	3. Testing HDF5 libraries and tools
-	   You may try to run check.com files in the following directories
-
-	   [.test]
-	   [.fortran.test]
-	   [.c__.test]
-	   [.examples]
-	   [.fortran.examples]
-	   [.c__.examples]
-
-	4. Installing HDF5 libraries
-	   Currently one has to manually copy *.olb, public *.h (all header
-           files that do not have "private" in file name) iheader files and 
-           Fortran modules files from 
-           [.src], [.fortran.src] and [.c__.src] directories
-
-	5. Known problems
+            It also runs test scripts to test C, Fortran and C++ libraries, and
+	    h5dump, h5diff, h5ls, h5repack and h5import utilties.
+
+	3. Installing HDF5 libraries
+
+	   Modify install.com file to specify installation directory and run
+	       @install
+           to install HDF5 C, Fortran, and C++ libraries, and utilities.
+           The script will create the directories shown below in the
+           installation directory:
+
+           [.HDF5]...
+           [.HDF5.INCLUDE]
+           [.HDF5.LIB]
+           [.HDF5.BIN]
+           [.HDF5.EXAMPLES]
+           [.HDF5.EXAMPLES.C]
+           [.HDF5.EXAMPLES.F90]
+           [.HDF5.EXAMPLES.CXX]
+
+           [.HDF5.EXAMPLES.*] directories contain make.com and check.com files 
+           to build examples against the installed libraries and to verify 
+           the installation.
+
+	3. Known problems
 
 	   - dsets test fails for test_scleoffset_double and
 	     test_scleoffset_double_2 tests when G_FLOAT double is used
-                                                          06/01/2006 EIP 
            - There is no support for szip compression filter.
-	   - There are few C and Fortran tests that fail (C mtime,  Fortran file_close and
-              multifile driver tests, probably more; all major tests succeed).
-	   - Mulitifile driver has not been tested yet.
-	   - Test scripts for some tools are missing; existing tools test scripts
-	      do not compare output with the expected output.
-           - Probably more :-)
+	   - Fortran multifile driver test fails; similar C test passes.
 
 
-	For help contact hdfhelp@hdf.ncsa.uiuc.edu or help@hdfgroup.org
+	For help contact help@hdfgroup.org
-- 
cgit v0.12