diff options
author | Frank Baker <fbaker@hdfgroup.org> | 2001-07-06 02:32:06 (GMT) |
---|---|---|
committer | Frank Baker <fbaker@hdfgroup.org> | 2001-07-06 02:32:06 (GMT) |
commit | cfa36589316578e0fd6b1f315b48bffc0bf745d0 (patch) | |
tree | 0e0042d948eaa355bd7aab61cf385f70073afaeb | |
parent | 1af1fe8d8af227d11cb10c7c65a7dfee90377bf3 (diff) | |
download | hdf5-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.html | 10 | ||||
-rw-r--r-- | doc/html/RM_H5P.html | 26 | ||||
-rw-r--r-- | doc/html/RM_H5T.html | 5 |
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> </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 <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 |