[svn-r684] RM_H5Front.html

   Added link to Tools.html
   Clean up formatting.
   Added RM_H5R.html, Ragged Arrays, but link is commented out for Beta.

RM_H5.html
   H5version       Removed patch number parameter.
   H5check_version Removed patch number parameter.
                   Corrected datatype to unsigned (was unsigned *).
                   Added missing "Purpose:" statement.

RM_H5A.html
   H5Aread/write   Added reference to data conversion limitations.

RM_H5D.html
   H5Dwrite        Added "Writing to an external dataset will fail
                   if the HDF5 file is not open for writing."
   H5Dread/write   Added reference to data conversion limitations.

RM_H5F.html
   H5Fflush        Added H5Fflush.

RM_H5G.html
   H5Gget_stat     Fixed formatting error.
                   Added mtime to the description of the data structure.
                   Added the following "Note:", per Robb's checkin mesage:
                   "Some systems will be able to record the time
                   accurately but unable to retrieve the correct time;
                   such systems (e.g., Irix64) will report an mtime
                   value of 0 (zero)."
                   Corrected successful return value.
   H5Gset_comment  Added the following statement to "Description:"
                   "Comments can be attached to any object that
                   has an object header, e.g., data sets, groups,
                   named data types, and data spaces,
                   but not symbolic links.

RM_H5P.html
	Cleaned up file formatting.

   H5Pset_filter         Added these three functions.
   H5Pget_nfilters
   H5Pget_filter

   H5Pget_deflate        Removed these three functions.  (Actually,
   H5Pset_compression    they are commented out, in case they should
   H5Pget_compression    be reinstated.)

RM_H5R.html
   Intial version of H5R reference manual entry, but still largely
   just a template.
   Not yet ready for distribution.
   Links to this document are currently commented out.

RM_H5S.html
   H5S_set_extent_simple Changed name to H5Sselect_extent_simple.
	now: H5Sselect_extent_simpl
   H5Sselect_npoints  Corrected return value.
        Now: H5Sget_select_npoints
   H5Sget_class          Reinstated to RM.  Changed name.
	now: H5Sget_space_type

   H5Soffset_simple      Added these 6 functions.  The there is a
   H5Sextent_copy        link to Dataspaces.html for the 10 "not yet
   H5Sset_extent_none    implemented (NYI)" functions.
   H5Sselect_all
   H5Sselect_none
   H5Sselect_valid

RM_H5T.html
   Added the following datatypes (though the list of native datatypes
   is commented out):
	H5T_NATIVE_HSIZE
	H5T_NATIVE_HSSIZE
	H5T_NATIVE_HERR
	H5T_NATIVE_HBOOL


Tools.html
   Corrected h5ls and h5repart sections.

Glossary.html
   Unlinked for Beta.

Copyright.html
   New file.
   Copyright statement, linked into User's Guide and Reference Manual.

General
   Changed the following function names:
	From:                       To:
	H5version                   H5get_libversion
	H5vers_check                H5check_version
	H5Anum_attrs                H5Aget_num_attrs
	H5Fget_create_template      H5Fget_create_plist
	H5Fget_access_template      H5Fget_access_plist
           And associated "template" -> "property list" edits.
	H5Gstat                     H5Gget_stat
	H5Sextent_npoints           H5Sget_simple_extent_npoints
	H5Sextent_ndims             H5Sget_simple_extent_ndims
	H5Sextent_dims              H5Sget_simple_extent_dims
	H5Sget_class                H5Sget_simple_extent_type
	H5Sselect_npoints           H5Sget_select_npoints
   Added links to Tools.html and RM_H5R.html (Ragged Arrays),
      though link to RM_H5R.html is commented out for now.

1 files changed, 245 insertions, 24 deletions

diff --git a/doc/src/RM_H5S.html b/doc/src/RM_H5S.html
index 8b2882c..64fd250 100644
--- a/doc/src/RM_H5S.html
+++ b/doc/src/RM_H5S.html
@@ -18,7 +18,10 @@ HDF5/H5S Draft API Specification
 H5S  
 <a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
 <a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
+<a href="Tools.html">Tools</a>&nbsp;&nbsp;
+<!--
 <a href="Glossary.html">Glossary</a>
+-->
 </center>
 <hr>
 
@@ -36,27 +39,62 @@ elements of a dataset.
 <ul>
     <li><a href="#Dataspace-Create">H5Screate</a>
     <li><a href="#Dataspace-CreateSimple">H5Screate_simple</a>
+    <li><a href="#Dataspace-IsSimple">H5Sis_simple</a>
+    <li><a href="#Dataspace-OffsetSimple">H5Soffset_simple</a>
     <li><a href="#Dataspace-Copy">H5Scopy</a>
-    <li><a href="#Dataspace-SelectNpoints">H5Sselect_npoints</a>
-    <li><a href="#Dataspace-SelectElements">H5Sselect_elements</a>
+    <li><a href="#Dataspace-ExtentClass">H5Sextent_class</a>
+    <li><a href="#Dataspace-ExtentCopy">H5Sextent_copy</a>
 </ul>
 </td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
 <ul>
-    <li><a href="#Dataspace-ExtentNpoints">H5Sextent_npoints</a>
-    <li><a href="#Dataspace-ExtentNdims">H5Sextent_ndims</a>
-    <li><a href="#Dataspace-ExtentDims">H5Sextent_dims</a>
-    <li><a href="#Dataspace-ExtentClass">H5Sextent_class</a>
+    <li><a href="#Dataspace-SetExtentSimple">H5Sset_extent_simple</a>
+    <li><a href="#Dataspace-SetExtentNone">H5Sset_extent_none</a>
+    <li><a href="#Dataspace-SelectNpoints">H5Sget_select_npoints</a>
+    <li><a href="#Dataspace-ExtentDims">H5Sget_simple_extent_dims</a>
+    <li><a href="#Dataspace-ExtentNdims">H5Sget_simple_extent_ndims</a>
+    <li><a href="#Dataspace-ExtentNpoints">H5Sget_simple_extent_npoints</a>
+    <li><a href="#Dataspace-GetSpaceType">H5Sget_space_type</a>
 </ul>
 </td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
 <ul>
-    <li><a href="#Dataspace-SetExtentSimple">H5Sset_extent_simple</a>
-    <li><a href="#Dataspace-IsSimple">H5Sis_simple</a>
+    <li><a href="#Dataspace-SelectElements">H5Sselect_elements</a>
+    <li><a href="#Dataspace-SelectAll">H5Sselect_all</a>
+    <li><a href="#Dataspace-SelectNone">H5Sselect_none</a>
+    <li><a href="#Dataspace-SelectValid">H5Sselect_valid</a>
     <li><a href="#Dataspace-SelectHyperslab">H5Sselect_hyperslab</a>
     <li><a href="#Dataspace-Close">H5Sclose</a>
 </ul>
 </td></tr>
 </table>
 
+<p>
+The following H5S functions are included in the HDF5 specification, 
+but have not yet been implemented.  They are described in the 
+<a href="Datatypes.html">The Data Type Interface (H5T)</a> section
+of the <cite>HDF5 User's Guide.</cite>.
+<table border=0>
+<tr><td valign=top>
+<ul>
+    <li>H5Scommit
+    <li>H5Sis_subspace
+    <li>H5Slock
+    <li>H5Sopen
+</ul>
+</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
+<ul>
+    <li>H5Sselect_name
+    <li>H5Sselect_op
+    <li>H5Sselect_order
+</ul>
+</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top>
+<ul>
+    <li>H5Ssubspace
+    <li>H5Ssubspace_name
+    <li>H5Ssubspace_location
+</ul>
+</td></tr>
+</table>
+
 
 <hr>
 <dl>
@@ -196,18 +234,89 @@ elements of a dataset.
 </dl>
 
 
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Dataspace-SelectAll">H5Sselect_all</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Sselect_all</code>(<em>hid_t</em> <code>space_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Selects the entire dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sselect_all</code> selects the entire extent
+    of the dataspace <code>space_id</code>.
+    <p>
+    More specifically, <code>H5Sselect_all</code> selects 
+    the special <tt>5S_SELECT_ALL</tt> region for the dataspace
+    <code>space_id</code>.  <tt>H5S_SELECT_ALL</tt> selects the
+    entire dataspace for any dataspace it is applied to.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>IN: The identifier for the dataspace in which the 
+                selection is being made.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns SUCCEED (0) if successful;
+        otherwise FAIL (-1).
+</dl>
+
+
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Dataspace-SelectNone">H5Sselect_none</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Sselect_none</code>(<em>hid_t</em> <code>space_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Resets the selection region to include no elements.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sselect_none</code> resets the selection region 
+    for the dataspace <code>space_id</code> to include no elements.     
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>IN: The identifier for the dataspace in which the 
+                selection is being reset.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns SUCCEED (0) if successful;
+        otherwise FAIL (-1).
+</dl>
+
 
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Dataspace-SelectValid">H5Sselect_valid</a>
+<dt><strong>Signature:</strong>
+    <dd><em>hbool_t</em> <code>H5Sselect_valid</code>(<em>hid_t</em> <code>space_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Verifies that the selection is within the extent of the dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sselect_valid</code> verifies that the selection 
+    for the dataspace <code>space_id</code> is within the extent
+    of the dataspace if the current offset for the dataspace is used.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>The identifier for the dataspace in which the 
+                selection is being reset.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns <tt>TRUE</tt> if the selection is contained within 
+        the extent and <tt>FALSE</tt> if it is not.
+        Returns <tt>FAIL</tt> (<tt>-1</tt>) on error conditions 
+        such as the selection or extent not being defined.
+</dl>
 
 
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Dataspace-ExtentNpoints">H5Sextent_npoints</a>
+<dt><strong>Name:</strong> <a name="Dataspace-ExtentNpoints">H5Sget_simple_extent_npoints</a>
 <dt><strong>Signature:</strong>
-    <dd><em>hsize_t</em> <code>H5Sextent_npoints</code>(<em>hid_t </em><code>space_id</code>)
+    <dd><em>hsize_t</em> <code>H5Sget_simple_extent_npoints</code>(<em>hid_t </em><code>space_id</code>)
 <dt><strong>Purpose:</strong>
     <dd>Determines the number of elements in a dataspace.
 <dt><strong>Description:</strong>
-    <dd><code>H5Sextent_npoints</code> determines the number of elements 
+    <dd><code>H5Sget_simple_extent_npoints</code> determines the number of elements 
         in a dataspace.  For example, a simple 3-dimensional dataspace 
         with dimensions 2, 3, and 4 would have 24 elements.
 <dt><strong>Parameters:</strong>
@@ -223,13 +332,13 @@ elements of a dataset.
 
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Dataspace-SelectNpoints">H5Sselect_npoints</a>
+<dt><strong>Name:</strong> <a name="Dataspace-SelectNpoints">H5Sget_select_npoints</a>
 <dt><strong>Signature:</strong>
-    <dd><em>hsize_t</em> <code>H5Sselect_npoints</code>(<em>hid_t</em> <code>space_id</code>)
+    <dd><em>hsize_t</em> <code>H5Sget_select_npoints</code>(<em>hid_t</em> <code>space_id</code>)
 <dt><strong>Purpose:</strong>
     <dd>Determines the number of elements in a dataspace.
 <dt><strong>Description:</strong>
-    <dd><code>H5Sselect_npoints</code> determines the number of elements 
+    <dd><code>H5Sget_select_npoints</code> determines the number of elements 
         in the current selection of a dataspace.
 <dt><strong>Parameters:</strong>
     <dl>
@@ -237,20 +346,20 @@ elements of a dataset.
             <dd>Dataspace identifier.
     </dl>
 <dt><strong>Returns:</strong>
-    <dd>Returns a dataspace identifier if successful; 
+    <dd>Returns the number of elements in the selection if successful; 
         otherwise FAIL (-1).
 </dl>
 
 
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Dataspace-ExtentNdims">H5Sextent_ndims</a>
+<dt><strong>Name:</strong> <a name="Dataspace-ExtentNdims">H5Sget_simple_extent_ndims</a>
 <dt><strong>Signature:</strong>
-    <dd><em>int</em> <code>H5Sextent_ndims</code>(<em>hid_t</em> <code>space_id</code>)
+    <dd><em>int</em> <code>H5Sget_simple_extent_ndims</code>(<em>hid_t</em> <code>space_id</code>)
 <dt><strong>Purpose:</strong>
     <dd>Determines the dimensionality of a dataspace.
 <dt><strong>Description:</strong>
-    <dd><code>H5Sextent_ndims</code> determines the dimensionality (or rank) 
+    <dd><code>H5Sget_simple_extent_ndims</code> determines the dimensionality (or rank) 
         of a dataspace.
 <dt><strong>Parameters:</strong>
     <dl>
@@ -265,16 +374,16 @@ elements of a dataset.
 
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Dataspace-ExtentDims">H5Sextent_dims</a>
+<dt><strong>Name:</strong> <a name="Dataspace-ExtentDims">H5Sget_simple_extent_dims</a>
 <dt><strong>Signature:</strong>
-    <dd><em>int</em> <code>H5Sextent_dims</code>(<em>hid_t</em> <code>space_id</code>,
+    <dd><em>int</em> <code>H5Sget_simple_extent_dims</code>(<em>hid_t</em> <code>space_id</code>,
         <em>hsize_t *</em><code>dims</code>,
         <em>hsize_t *</em><code>maxdims</code>
     )
 <dt><strong>Purpose:</strong>
     <dd>Retrieves dataspace dimension size and maximum size.
 <dt><strong>Description:</strong>
-    <dd><code>H5Sextent_dims</code> returns the size and maximum sizes 
+    <dd><code>H5Sget_simple_extent_dims</code> returns the size and maximum sizes 
         of each dimension of a dataspace through the <code>dims</code> 
         and <code>maxdims</code> parameters.
 <dt><strong>Parameters:</strong>
@@ -294,9 +403,35 @@ elements of a dataset.
 
 <hr>
 <dl>
+<dt><strong>Name:</strong> <a name="Dataspace-GetSpaceType">H5Sget_space_type</a>
+<dt><strong>Signature:</strong>
+    <dd><em>H5S_class_t</em> <code>H5Sget_space_type</code>(<em>hid_t</em> <code>space_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Determine the current class of a dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sget_space_type</code> queries a dataspace to determine the 
+        current class of a dataspace.  
+        <p>
+        The function returns a class name, one of the following: 
+            <code>H5S_SCALAR</code>, 
+            <code>H5S_SIMPLE</code>, or 
+            <code>H5S_NONE</code>.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>Dataspace identifier.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns a dataspace class name if successful; 
+        otherwise FAIL (-1).
+</dl>
+
+
+<hr>
+<dl>
 <dt><strong>Name:</strong> <a name="Dataspace-SetExtentSimple">H5Sset_extent_simple</a>
 <dt><strong>Signature:</strong>
-    <dd><em>herr_t</em> <code>H5S_set_extent_simple</code>(<em>hid_t</em> <code>space_id</code>,
+    <dd><em>herr_t</em> <code>H5Sset_extent_simple</code>(<em>hid_t</em> <code>space_id</code>,
         <em>int</em> <code>rank</code>,
         <em>const hsize_t *</em><code>current_size</code>,
         <em>const hsize_t *</em><code>maximum_size</code>
@@ -304,7 +439,7 @@ elements of a dataset.
 <dt><strong>Purpose:</strong>
     <dd>Sets or resets the size of an existing dataspace.
 <dt><strong>Description:</strong>
-    <dd><code>H5S_set_extent_simple</code> sets or resets the size of 
+    <dd><code>H5Sset_extent_simple</code> sets or resets the size of 
         an existing dataspace.
         <p>
         <code>rank</code> is the dimensionality, or number of 
@@ -360,6 +495,39 @@ elements of a dataset.
 
 <hr>
 <dl>
+<dt><strong>Name:</strong> <a name="Dataspace-OffsetSimple">H5Soffset_simple</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Soffset_simple</code>(<em>hid_t</em> <code>space_id</code>,
+    <em>const hssize_t *</em><code>offset</code>
+    )
+<dt><strong>Purpose:</strong>
+    <dd>Sets the offset of a simple dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Soffset_simple</code> sets the offset of a 
+    simple dataspace <code>space_id</code>.  The <code>offset</code> 
+    array must be the same number of elements as the number of 
+    dimensions for the dataspace.  If the <code>offset</code> 
+    array is set to <TT>NULL</TT>, the offset for the dataspace 
+    is reset to 0.
+    <p>
+    This function allows the same shaped selection to be moved 
+    to different locations within a dataspace without requiring it 
+    to be redefined.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>IN: The identifier for the dataspace object to reset.
+        <dt><em>const hssize_t *</em><code>offset</code>
+            <dd>IN: The offset at which to position the selection.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns SUCCEED (0) if successful;
+        otherwise FAIL (-1).
+</dl>
+
+
+<hr>
+<dl>
 <dt><strong>Name:</strong> <a name="Dataspace-ExtentClass">H5Sextent_class</a>
 <dt><strong>Signature:</strong>
     <dd><em>H5S_class_t</em> <code>H5Sextent_class</code>(<em>hid_t</em> <code>space_id</code>)
@@ -385,6 +553,56 @@ elements of a dataset.
 
 <hr>
 <dl>
+<dt><strong>Name:</strong> <a name="Dataspace-ExtentCopy">H5Sextent_copy</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Sextent_copy</code>(<em>hid_t</em> <code>dest_space_id</code>,
+    <em>hid_t</em> <code>source_space_id</code>
+    )
+<dt><strong>Purpose:</strong>
+    <dd>Copies the extent of a dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sextent_copy</code> copies the extent from 
+    <code>source_space_id</code> to <code>dest_space_id</code>. 
+    This action may change the type of the dataspace.  
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>dest_space_id</code>
+            <dd>IN: The identifier for the dataspace from which 
+                the extent is copied.
+        <dt><em>hid_t</em> <code>source_space_id</code>
+            <dd>IN: The identifier for the dataspace to which 
+                the extent is copied.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns SUCCEED (0) if successful;
+        otherwise FAIL (-1).
+</dl>
+
+
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Dataspace-SetExtentNone">H5Sset_extent_none</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Sset_extent_none</code>(<em>hid_t</em> <code>space_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Removes the extent from a dataspace.
+<dt><strong>Description:</strong>
+    <dd><code>H5Sset_extent_none</code> removes the extent from 
+    a dataspace and sets the type to <tt>H5S_NONE</tt>.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>space_id</code>
+            <dd>The identifier for the dataspace from which
+                the extent is to be removed.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns SUCCEED (0) if successful;
+        otherwise FAIL (-1).
+</dl>
+
+
+<hr>
+<dl>
 <dt><strong>Name:</strong> <a name="Dataspace-SelectHyperslab">H5Sselect_hyperslab</a>
 <dt><strong>Signature:</strong>
     <dd><em>herr_t</em> <code>H5Sselect_hyperslab</code>(<em>hid_t</em> <code>space_id</code>,
@@ -514,7 +732,10 @@ I/O is performed.
 H5S&nbsp;&nbsp;
 <a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
 <a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
+<a href="Tools.html">Tools</a>&nbsp;&nbsp;
+<!--
 <a href="Glossary.html">Glossary</a>
+-->
 </center>
 <hr>
 
@@ -522,7 +743,7 @@ H5S&nbsp;&nbsp;
 <a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a> 
 
 <br>
-Last modified:  14 July 1998
+Last modified:  1 September 1998
 
 </body>
 </html>