summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/html/RM_H5D.html30
1 files changed, 23 insertions, 7 deletions
diff --git a/doc/html/RM_H5D.html b/doc/html/RM_H5D.html
index 3dffe5e..84cf307 100644
--- a/doc/html/RM_H5D.html
+++ b/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>