[svn-r8949]

Purpose:
    H5Pset_szip -- major rewrite
    H5Dcreate -- added a note regarding SZIP

Description:
    H5Pset_szip -- Rrestructured and rewrote H5Pset_szip Description and
        Notes to explain SZIP usage more completely, to capture limitations
        and potential pitfalls, to offer a tunign suggestion, and to
        segregate discussion of SZIP parameters that may be of interest to
        users familiar with SZIP in other environments.
        Updated parameter discussion in Description and Parameter sections.
        Described ways in which erroneous SZIP setup can cause H5Dcreate
        to fail.
    H5Dcreate -- Added note to see the H5Pset_szip RM entry if H5Dcreate
        fails and SZIP compression is to be used with the dataset.

Platforms tested:
    Mozilla

doc/html/RM_H5D.html

@@ -309,6 +309,13 @@ END SUBROUTINE h5dclose_f
 	“HDF5 Datasets” chapter of 
 	the new <cite>HDF5 User's Guide</cite>, 
 	which is being prepared for release.
+<dt><strong>Note:</strong>
+    <dd>If <code>H5Dcreate</code> presents an unexplained failure
+        and SZIP compression is to be used on the dataset, 
+        see the description of 
+        <a href="RM_H5P.html#Property-SetSzip"><code>H5Pset_szip</code></a>.
+        There are circumstances in which an SZIP setup error will cause
+        <code>H5Dcreate</code> to fail.
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>loc_id</code>
@@ -1573,7 +1580,7 @@ And in this document, the
 Describes HDF5 Release 1.6.2, February 2004
 </address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT">
 <!--
-document.writeln("Last modified: 16 October 2003");
+document.writeln("Last modified: 26 July 2004");
 -->
 </SCRIPT>