[svn-r435] ./INSTALL

./INSTALL_MAINT
./README
./RELEASE
	Partially updated for second alpha, but haven't updated
	version numbers yet.

./src/H5.c
./src/H5A.c
./src/H5AC.c
./src/H5B.c
./src/H5D.c
./src/H5F.c
./src/H5Fcore.c
./src/H5Ffamily.c
./src/H5Fistore.c
./src/H5Fmpio.c
./src/H5Fsec2.c
./src/H5Fsplit.c
./src/H5Fstdio.c
./src/H5G.c
./src/H5Gnode.c
./src/H5HG.c
./src/H5HL.c
./src/H5I.c
./src/H5MM.c
./src/H5MMprivate.h
./src/H5O.c
./src/H5Oattr.c
./src/H5Ocomp.c
./src/H5Ocont.c
./src/H5Odtype.c
./src/H5Oefl.c
./src/H5Olayout.c
./src/H5Oname.c
./src/H5Osdspace.c
./src/H5Oshared.c
./src/H5Ostab.c
./src/H5P.c
./src/H5S.c
./src/H5T.c
./src/H5Tconv.c
./src/H5detect.c
./test/hyperslab.c
./test/istore.c
	Changed memory allocation functions so they fail instead of
	dumping core.  The `x' was removed from the name to remind us
	of that: H5MM_xmalloc() -> H5MM_malloc(), etc.

	H5MM_calloc() takes one argument like H5MM_malloc() instead of
	two like calloc() because we almost always called it with `1'
	for one of the arguments anyway.  The only difference between
	the two functions is that H5MM_calloc() returns memory which
	is initialized to zero.

./src/H5Gent.c
./src/H5Gprivate.h
	Removed H5G_ent_calloc() since it wasn't used.

./src/H5Fistore.c
	Fixed a bug found by Albert.  Thanks, Albert!  This fix
	combined with the changes to memory allocation prevent the
	library from failing an assertion if the application uses an
	unreasonable size for chunks (like Alberts 10000x10000x4).

./src/H5MF.c
./src/H5MFprivate.h
	Changed H5MF_free() to H5MF_xfree() since calling it with an
	undefined address is allowed.

1 files changed, 13 insertions, 11 deletions

diff --git a/INSTALL b/INSTALL
index 2622c5f..639e3ba 100644
--- a/INSTALL
+++ b/INSTALL
@@ -20,7 +20,8 @@ for the install may be found in the file:  INSTALL.ascired.
 Step 0: Install optional third-party packages.
 
     * GNU zlib compression library, version 1.0.2 or later is used for
-      the `deflate' compression method.
+      the `deflate' compression method. If libz.a cannot be found then
+      this form of compression is not compiled into the library.
 
 Step 1. Unpack the source tree.
 
@@ -28,10 +29,9 @@ Step 1. Unpack the source tree.
       the following commands:
 
 	$ tar xf hdf5-1.0.0a.tar				OR
-	$ gunzip <hdf5-1.0.0a.tar.gz |tar xf -		OR
+	$ gunzip <hdf5-1.0.0a.tar.gz |tar xf -			OR
 	$ bunzip2 <hdf5-1.0.0a.tar.bz2 |tar xf -		OR
-	$ uncompress -c <hdf5-1.0.0a.tar.Z | tar xf -
-
+	$ uncompress -c <hdf5-1.0.0a.tar.Z |tar xf -
 
 Step 2. Configure makefiles.
 
@@ -85,6 +85,13 @@ Step 2. Configure makefiles.
       name of the file is the result of running ./bin/config.guess.
       Use config/BlankForm as a template.
 
+    * The library can print the names, arguments and values, and
+      return value from all API functions.  The code that does this is 
+      enabled with the `--enable-tracing' configuration switch. In
+      order to actually see tracing output one should set the
+      environment variable HDF5_TRACE to a file descriptor number such 
+      as `2'.
+
     * You can see a list of other configuration options by saying
 
 	$ ./configure --help
@@ -100,12 +107,6 @@ Step 3. Compile library, tests, and programs.
       environment variable in the previous step then use that command
       instead. The same applies below.
 
-      Note: If you're re-building the library after changing some
-      files and you're not using GNU make and gcc, then you should say
-      `make clean' from the top directory between each build attempt
-      since the development Makefiles don't have complete dependency
-      information yet.
-
       Note: When using GNU make you can add `-j -l6' to the make
       command to compile in parallel on SMP machines.  Do not give a
       number after the `-j' since GNU make will turn it off for
@@ -117,7 +118,8 @@ Step 4. Run confidence tests.
 
 	$ make test
 
-      The command will fail if any test fails.
+      The command will fail if any test fails, and one will see the
+      word "*FAIL*" in the output.
 
       Note: some old versions of make will report that `test is up to
       date'. If this happens then run `make _test' instead or run