[svn-r1557] INSTALL:

    Edited for 1.2.0beta release.
INSTALL.ascired:
    Updated with simplified steps.
INSTALL_parallel:
    Updated with information that was in INSTALL and INSTALL.parallel.
INSTALL_parallel.ascired:
    Removed old setup no longer needed.
    RUNPARALEL, RUNSERIAL, disable-shared are specified in config/intel-osf1.
README:
    Update mailing list subscription instruction.
RELEASE:
    Updated for 1.2.0beta release information.
INSTALL_Windows.txt:
    Contains Windows platform installation instructions.
INSTALL.parallel:
    Removed because its content has been moved to INSTALL_parallel.

1 files changed, 22 insertions, 42 deletions

diff --git a/INSTALL b/INSTALL
index 4b4d3b8..b9a38f3 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,14 +1,13 @@
 -*- outline -*-
 
-This file contains instructions for the installation of HDF5 on
-Unix-like systems. Users of the Intel TFLOPS machine should see the
-INSTALL.ascired for instructions.
+This file contains instructions for the installation of HDF5 software.
 
 * Obtaining HDF5
 	The latest supported public release of HDF5 is available from
-	ftp://hdf.ncsa.uiuc.edu/pub/dist/HDF5 and is available in tar
-	format uncompressed or compressed with compress, gzip, or
-	bzip2.
+	ftp://hdf.ncsa.uiuc.edu/pub/dist/HDF5.  For Unix platforms, it
+        is available in tar format uncompressed or compressed with
+	compress, gzip, or bzip2.  For Microsoft Windows, it is in
+        ZIP format.
 
 	The HDF team also makes snapshots of the source code available
 	on a regular basis. These snapshots are unsupported (that is,
@@ -63,6 +62,14 @@ INSTALL.ascired for instructions.
 	$ make check
 	$ make install
 
+** TFLOPS
+	Users of the Intel TFLOPS machine, after reading this file,
+	should see the INSTALL.ascired for more instructions.
+
+** Windows
+	Users of Microsoft Windows should see the INSTALL_Windows.txt
+	for detailed instructions.
+
 * HDF5 dependencies
 ** Zlib
 	The HDF5 library has a predefined compression filter that uses 
@@ -169,11 +176,17 @@ INSTALL.ascired for instructions.
 
 	    $ CC=/usr/local/mpi/bin/mpicc ./configure
 
-	On Irix64 the default compiler is `cc -64'. To use an
+	On Irix64 the default compiler is `cc'. To use an
 	alternate compiler specify it with the CC variable:
 
 	    $ CC='cc -o32' ./configure
 
+	One may also use various environment variables to change the
+	behavior of the compiler.  E.g., to ask for -n32 ABI:
+	    $ SGI_ABI=-n32
+	    $ export SGI_ABI
+	    $ ./configure
+
 *** Additional compilation flags
 	If addtional flags must be passed to the compilation commands
 	then specify those flags with the CFLAGS variable. For
@@ -313,42 +326,9 @@ INSTALL.ascired for instructions.
 
 *** Parallel vs. serial library
 	The HDF5 library can be configured to use MPI and MPI-IO for
-	parallelizm on a distributed multi-processor system. The easy
-	way to do this is to have a properly installed parallel
-	compiler (e.g., MPICH's mpicc or IBM's mpcc) and supply that
-	executable as the value of the CC environment variable:
-
-	    $ CC=mpcc ./configure
-	    $ CC=/usr/local/mpi/bin/mpicc ./configure
-
-	If no such wrapper script is available then you must specify
-	your normal C compiler along with the distribution of
-	MPI/MPI-IO which is to be used (values other than `mpich' will 
-	be added at a later date):
-
-	    $ ./configure --enable-parallel=mpich
-
-	If the MPI/MPI-IO include files and/or libraries cannot be
-	found by the compiler then their directories must be given as
-	arguments to CPPFLAGS and/or LDFLAGS:
-
-	    $ CPPFLAGS=-I/usr/local/mpi/include \
-	      LDFLAGS=-L/usr/local/mpi/lib/LINUX/ch_p4 \
-	      ./configure --enable-parallel=mpich
-
-	If a parallel library is being built then configure attempts
-	to determine how to run a parallel application on one
-	processor and on many processors.  If the compiler is mpicc
-	and the user hasn't specified values for RUNSERIAL and
-	RUNPARALLEL then configure chooses `mpirun' from the same
-	directory as `mpicc':
-
-	    RUNSERIAL:    /usr/local/mpi/bin/mpirun -np 1
-	    RUNPARALLEL:  /usr/local/mpi/bin/mpirun -np $${NPROCS:=2}
+	parallelizm on a distributed multi-processor system.  Read the
+	file INSTALL_parallel for detailed explanations.
 
-	The `$${NPROCS:=2}' will be substituted with the value of the
-	NPROCS environment variable at the time `make check' is run
-	(or the value 2).
 
 ** Building
 	The library, confidence tests, and programs can be build by