diff options
author | Frank Baker <fbaker@hdfgroup.org> | 2003-10-29 18:37:05 (GMT) |
---|---|---|
committer | Frank Baker <fbaker@hdfgroup.org> | 2003-10-29 18:37:05 (GMT) |
commit | 03bed9f9ef980530fa7590ef201cb214dab2e6f5 (patch) | |
tree | db37712c0f0472fc9f8863aef23f7a4a2cb73b55 /doc | |
parent | bbe23c026f974be06e2aa86cff55cd255b33e2d0 (diff) | |
download | hdf5-03bed9f9ef980530fa7590ef201cb214dab2e6f5.zip hdf5-03bed9f9ef980530fa7590ef201cb214dab2e6f5.tar.gz hdf5-03bed9f9ef980530fa7590ef201cb214dab2e6f5.tar.bz2 |
[svn-r7787]
Purpose:
Fixes for user-reported Ref Manual bugs:
H5Gget_objname_by_idx: corrected 'size' parameter specification
H5Sselect_elements: Expanded 'coord' parameter description to make it
clear that values are 0-based.
Additional minor copy edits and formatting cleanup.
Platforms tested:
IE 5
Diffstat (limited to 'doc')
-rw-r--r-- | doc/html/RM_H5G.html | 4 | ||||
-rw-r--r-- | doc/html/RM_H5S.html | 35 |
2 files changed, 23 insertions, 16 deletions
diff --git a/doc/html/RM_H5G.html b/doc/html/RM_H5G.html index 5a7c928..c562b58 100644 --- a/doc/html/RM_H5G.html +++ b/doc/html/RM_H5G.html @@ -612,7 +612,7 @@ SUBROUTINE <dd><em>ssize_t</em> <code>H5Gget_objname_by_idx</code>(<em>hid_t</em> <code>loc_id</code>, <em>hsize_t</em> <code>idx</code>, <em>char *</em><code>name</code>, - <em>size_t*</em> <code>size</code> ) + <em>size_t</em> <code>size</code> ) <dt><strong>Purpose:</strong> <dd>Returns a name of an object specified by an index. <dt><strong>Description:</strong> @@ -1402,7 +1402,7 @@ And in this document, the Describes HDF5 Release 1.7, the unreleased development branch; working toward HDF5 Release 1.8.0 </address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT"> <!-- -document.writeln("Last modified: 21 October 2003"); +document.writeln("Last modified: 29 October 2003"); --> </SCRIPT> diff --git a/doc/html/RM_H5S.html b/doc/html/RM_H5S.html index 9a1a9c8..b977c0b 100644 --- a/doc/html/RM_H5S.html +++ b/doc/html/RM_H5S.html @@ -1236,13 +1236,17 @@ END SUBROUTINE h5sselect_all_f <dd>Selects array elements to be included in the selection for a dataspace. <dt><strong>Description:</strong> <dd><code>H5Sselect_elements</code> selects array elements to be - included in the selection for the <code>space_id</code> - dataspace. The number of elements selected must be set with - the <code>num_elements</code>. The <code>coord</code> array - is a two-dimensional array of size <em>dataspace rank</em> - by <code>num_elements</code> (ie. a list of coordinates in - the array). The order of the element coordinates in the - <code>coord</code> array also specifies the order in which + included in the selection for the <code>space_id</code> dataspace. + <p> + The number of elements selected is set in the + <code>num_elements</code> parameter. + <p> + The <code>coord</code> array is a two-dimensional array of + size <code><i>dataspace_rank</i></code> by <code>num_elements</code> + containing a list of of zero-based values specifying the + coordinates in the dataset of the selected elements. + The order of the element coordinates in the + <code>coord</code> array specifies the order in which the array elements are iterated through when I/O is performed. Duplicate coordinate locations are not checked for. <p> @@ -1255,7 +1259,8 @@ END SUBROUTINE h5sselect_all_f <tr><td valign=top> <code>H5S_SELECT_SET</code> </td><td valign=top> - Replaces the existing selection with the parameters from this call. + Replaces the existing selection with the parameters from + this call. Overlapping blocks are not supported with this operator. <!-- </td></tr><tr><td valign=top> <code>H5S_SELECT_OR</code> @@ -1264,11 +1269,13 @@ END SUBROUTINE h5sselect_all_f </td></tr><tr><td valign=top> <code>H5S_SELECT_APPEND</code> </td><td valign=top> - Adds the new selection following the last element of the existing selection. + Adds the new selection following the last element of the + existing selection. </td></tr><tr><td valign=top> <code>H5S_SELECT_PREPEND </code> </td><td valign=top> - Adds the new selection preceding the first element of the existing selection. + Adds the new selection preceding the first element of the + existing selection. </td></tr> </table> </center> @@ -1281,13 +1288,13 @@ END SUBROUTINE h5sselect_all_f <dt><em>hid_t</em> <code>space_id</code> <dd>Identifier of the dataspace. <dt><em>H5S_seloper_t</em> <code>op</code> - <dd>operator specifying how the new selection is to be + <dd>Operator specifying how the new selection is to be combined with the existing selection for the dataspace. <dt><em>const size_t</em> <code>num_elements</code> <dd>Number of elements to be selected. <dt><em>const hssize_t *</em><code>coord</code>[ ] - <dd>A 2-dimensional array specifying the coordinates of the - elements being selected. + <dd>A 2-dimensional array of 0-based values specifying the + coordinates of the elements being selected. </dl> <dt><strong>Returns:</strong> <dd>Returns a non-negative value if successful; @@ -1800,7 +1807,7 @@ And in this document, the Describes HDF5 Release 1.7, the unreleased development branch; working toward HDF5 Release 1.8.0 </address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT"> <!-- -document.writeln("Last modified: 21 October 2003"); +document.writeln("Last modified: 29 October 2003"); --> </SCRIPT> |