[svn-r9232] Purpose:

H5Dcreate may fail if there has been an error in setting up the DCPL.
Description:
    To make sure that it is well noted in Relelase 1.6.3, this is a
    first cut at a generalized description of this potential failure.
    An improved description of the problem remains on the "To Do" list.
Platforms tested:
    Mozilla

doc/html/RM_H5D.html

@@ -310,12 +310,28 @@ END SUBROUTINE h5dclose_f
 	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.
+    <dd><code>H5Dcreate</code> can fail if there has been an error
+        in setting up an element of the dataset creation property list.
+        In such cases, each item in the property list must be examined
+        to ensure that the setup satisfies to all required conditions.
+        This problem is most likely to occur with the use of filters.
+        <p>
+        For example, <code>H5Dcreate</code> will fail without a meaningful
+        explanation if 
+        <ul>
+          <li>SZIP compression is being used on the dataset 
+          <li>but the available SZIP library is configured as decode-only
+              (i.e., applications can read but not write SZIP-encoded data).
+        </ul>
+        <p>
+        In such a case, one would refer to the description of 
+        <a href="RM_H5P.html#Property-SetSzip"><code>H5Pset_szip</code></a>,
+        looking for any conditions or requirements that might affect the
+        local computing environment.
+        <!--
+        <p>
+        Other known similar problems can occur with . . .
+        --> 
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>loc_id</code>
@@ -1501,7 +1517,7 @@ And in this document, the
 Describes HDF5 Release 1.6.2, February 2004
 </address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT">
 <!--
-document.writeln("Last modified: 2 August 2004");
+document.writeln("Last modified: 8 September 2004");
 -->
 </SCRIPT>