summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>2001-07-06 02:32:06 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>2001-07-06 02:32:06 (GMT)
commitcfa36589316578e0fd6b1f315b48bffc0bf745d0 (patch)
tree0e0042d948eaa355bd7aab61cf385f70073afaeb
parent1af1fe8d8af227d11cb10c7c65a7dfee90377bf3 (diff)
downloadhdf5-cfa36589316578e0fd6b1f315b48bffc0bf745d0.zip
hdf5-cfa36589316578e0fd6b1f315b48bffc0bf745d0.tar.gz
hdf5-cfa36589316578e0fd6b1f315b48bffc0bf745d0.tar.bz2
[svn-r4126] Purpose:
Bugfixes and editing. Description: RM_H5T.html H5Tget_class -- Added H5T_ARRAY to list of valid datatype class IDs. Closes bug #611. -- Minor formatting issue in same command. RM_H5F.html H5Fflush -- Added "Note:" re H5 vs OS buffers. H5Fclose -- Corrected mentions of H5close to read H5Fclose. RM_H5P.html Removed () from several H5* function names in running text. Platforms tested: IE 5
-rw-r--r--doc/html/RM_H5F.html10
-rw-r--r--doc/html/RM_H5P.html26
-rw-r--r--doc/html/RM_H5T.html5
3 files changed, 24 insertions, 17 deletions
diff --git a/doc/html/RM_H5F.html b/doc/html/RM_H5F.html
index 0f15852..fbcbcc2 100644
--- a/doc/html/RM_H5F.html
+++ b/doc/html/RM_H5F.html
@@ -291,6 +291,12 @@ facilitate moving easily between them.</i>
<td align=left valign=bottom>Flushes only the specified file.</td></tr>
</table>
</center>
+<dt><strong>Note:</strong>
+ <dd>HDF5 does not possess full control over buffering.
+ <code>H5Fflush</code> flushes the internal HDF5 buffers then
+ asks the operating system (the OS) to flush the system buffers for the
+ open files. After that, the OS is responsible for ensuring that
+ the data is actually flushed to disk.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t </em><code>object_id</code>
@@ -447,11 +453,11 @@ facilitate moving easily between them.</i>
<p>
<strong>EXCEPTION:</strong>
Note the following deviation from the above-described behavior.
- If <code>H5close</code> is called for a file but one or more
+ If <code>H5Fclose</code> is called for a file but one or more
objects within the file remain open, those objects will remain
accessible until they are individually closed.
Thus, if the dataset <code>data_sample</code> is open when
- <code>H5close</code> is called for the file containing it,
+ <code>H5Fclose</code> is called for the file containing it,
<code>data_sample</code> will remain open and accessible
(including writable) until it is explicitely closed.
The file will be automatically closed once all objects in the
diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html
index ea596c2..ba8347d 100644
--- a/doc/html/RM_H5P.html
+++ b/doc/html/RM_H5P.html
@@ -407,7 +407,7 @@ facilitate moving easily between them.</i>
<dd><code>H5Pget_class</code> returns the property list class for the
property list identified by the <code>plist</code> parameter.
Valid property list classes are defined in the description of
- <code>H5Pcreate()</code>.
+ <code>H5Pcreate</code>.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>plist</code>
@@ -1167,7 +1167,7 @@ facilitate moving easily between them.</i>
<dd><code>H5Pget_external</code> returns information about an external
file. The external file is specified by its index, <code>idx</code>,
which is a number from zero to N-1, where N is the value
- returned by <code>H5Pget_external_count()</code>.
+ returned by <code>H5Pget_external_count</code>.
At most <code>name_size</code> characters are copied into the
<code>name</code> array. If the external file name is
longer than <code>name_size</code> with the null terminator, the
@@ -1338,16 +1338,16 @@ facilitate moving easily between them.</i>
<td>&nbsp;&nbsp;</td>
<td valign=top>If this bit is set then the filter is
optional. If the filter fails (see below) during an
- <code>H5Dwrite()</code> operation then the filter is
+ <code>H5Dwrite</code> operation then the filter is
just excluded from the pipeline for the chunk for which
it failed; the filter will not participate in the
- pipeline during an <code>H5Dread()</code> of the chunk.
+ pipeline during an <code>H5Dread</code> of the chunk.
This is commonly used for compression filters: if the
compression result would be larger than the input then
the compression filter returns failure and the
uncompressed data is stored in the file. If this bit is
- clear and a filter fails then <code>H5Dwrite()</code>
- or <code>H5Dread()</code> also fails.</td>
+ clear and a filter fails then <code>H5Dwrite</code>
+ or <code>H5Dread</code> also fails.</td>
</tr>
</table>
</center>
@@ -1457,7 +1457,7 @@ facilitate moving easily between them.</i>
<p>
<code>filter_number</code> is a value between zero and
<em>N</em>-1, as described in
- <a href="#Property-GetNFilters"><code>H5Pget_nfilters()</code></a>.
+ <a href="#Property-GetNFilters"><code>H5Pget_nfilters</code></a>.
The function will return a negative value if the filter number
is out of range.
<p>
@@ -1469,7 +1469,7 @@ facilitate moving easily between them.</i>
for the filter, or an empty string.
<p>
The structure of the <code>flags</code> argument is discussed
- in <a href="#Property-SetFilter"><code>H5Pset_filter()</code></a>.
+ in <a href="#Property-SetFilter"><code>H5Pset_filter</code></a>.
<dt><strong>Note:</strong>
<dd>This function currently supports only the permanent filter
pipeline; <code>plist</code> must be a dataset creation property
@@ -1798,7 +1798,7 @@ facilitate moving easily between them.</i>
The total size of the raw data chunk cache and the preemption policy
are <em>rdcc_nbytes</em> and <em>rdcc_w0</em>.
<p>
- Any (or all) of the <code>H5Pget_cache()</code> pointer arguments
+ Any (or all) of the <code>H5Pget_cache</code> pointer arguments
may be null pointers.
<p>
The <em>rdcc_w0</em> value should be between 0 and 1 inclusive and
@@ -2138,7 +2138,7 @@ facilitate moving easily between them.</i>
<dd>Reads buffer settings.
<dt><strong>Description:</strong>
<dd><code>H5Pget_buffer</code> reads values previously set
- with H5Pset_buffer().
+ with H5Pset_buffer.
<dt><strong>Parameters:</strong>
<dl>
<dt><em>hid_t</em> <code>plist</code>
@@ -2252,7 +2252,7 @@ facilitate moving easily between them.</i>
in a dataset creation property list. This is a catch-all
function for defining compression methods
and is intended to be called from a wrapper such as
- <code>H5Pset_deflate()</code>. The dataset creation property
+ <code>H5Pset_deflate</code>. The dataset creation property
list <em>plist</em> is adjusted to use the specified
compression method. The <em>flags</em> is an 8-bit vector
which is stored in the file as part of the compression message
@@ -2931,8 +2931,8 @@ facilitate moving easily between them.</i>
<p>
The array <code>memb_name</code> should be a name generator
(a printf-style format with a %s which will be replaced with the
- name passed to <code>H5FDopen()</code>, usually from
- <code>H5Fcreate()</code> or <code>H5Fopen()</code>).
+ name passed to <code>H5FDopen</code>, usually from
+ <code>H5Fcreate</code> or <code>H5Fopen</code>).
<p>
The array <code>memb_addr</code> specifies the offsets within the
virtual address space, from <code>0</code> (zero) to
diff --git a/doc/html/RM_H5T.html b/doc/html/RM_H5T.html
index 8b977e0..0eb8a4b 100644
--- a/doc/html/RM_H5T.html
+++ b/doc/html/RM_H5T.html
@@ -822,6 +822,7 @@ H5Tget_overflow ()
<li><code>H5T_REFERENCE</code>
<li><code>H5T_ENUM</code>
<li><code>H5T_VLEN</code>
+ <li><code>H5T_ARRAY</code>
</ul>
<dt><strong>Parameters:</strong>
<dl>
@@ -830,7 +831,7 @@ H5Tget_overflow ()
</dl>
<dt><strong>Returns:</strong>
<dd>Returns datatype class identifier if successful;
- otherwise H5T_NO_CLASS (-1).
+ otherwise <code>H5T_NO_CLASS</code> (-1).
<dt><strong>Non-C API(s):</strong>
<dd><a href="fortran/h5t_FORTRAN.html#h5tget_class_f"
target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
@@ -2711,7 +2712,7 @@ H5T&nbsp;&nbsp;
<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
<br>
-Last modified: 19 February 2001
+Last modified: 5 July 2001
<br>
Describes HDF5 Release 1.5, Unreleased Development Branch