[svn-r7532]

Purpose:
    Alphabetized function entries
    Fortran90 descriptions for h5acreate_f and h5aclose_f

Platforms tested:
    IE 5, Safari

1 files changed, 254 insertions, 230 deletions

diff --git a/doc/html/RM_H5A.html b/doc/html/RM_H5A.html
index 27af3dc..90af1b7 100644
--- a/doc/html/RM_H5A.html
+++ b/doc/html/RM_H5A.html
@@ -61,8 +61,7 @@ And in this document, the
 </td></tr>
 </table>
 </center>
-<hr>
-<!-- #EndLibraryItem --><center>
+<hr><!-- #EndLibraryItem --><center>
 <h1>H5A: Attribute Interface</h1>
 </center>
 
@@ -199,16 +198,59 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 
 <!-- NEW PAGE -->
 <!-- NEW PAGE -->
+<!-- HEADER RIGHT "H5Aclose" -->
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Annot-Close">H5Aclose</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Aclose</code>(<em>hid_t</em> <code>attr_id</code>)
+<dt><strong>Purpose:</strong>
+    <dd>Closes the specified attribute.
+<dt><strong>Description:</strong>
+    <dd><code>H5Aclose</code> terminates access to the attribute 
+        specified by <code>attr_id</code> by releasing the identifier.
+        <p>
+        Further use of a released attribute identifier is illegal; 
+        a function using such an identifier will fail.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>attr_id</code>
+            <dd>IN: Attribute to release access to.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns a non-negative value if successful;
+        otherwise returns a negative value.
+<dt><strong>Fortran90 Interface:</strong> h5aclose_f
+    <dd>
+	<pre>
+SUBROUTINE h5aclose_f(attr_id, hdferr) 
+  IMPLICIT NONE
+  INTEGER(HID_T), INTENT(OUT) :: attr_id  ! Attribute identifier 
+  INTEGER, INTENT(OUT) :: hdferr       ! Error code
+                                       ! 0 on success and -1 on failure
+END SUBROUTINE h5aclose_f	
+	</pre>
+		
+		
+		<!--<dt><strong>Non-C API(s):</strong>
+    	<dd>
+        
+        <img src="Graphics/Java.gif"> 
+        <img src="Graphics/C++.gif">
+        -->
+</dl>
+
+<!-- NEW PAGE -->
 <!-- HEADER RIGHT "H5Acreate" -->
 <hr>
 <dl>
 <dt><strong>Name:</strong> <a name="Annot-Create">H5Acreate</a>
 <dt><strong>Signature:</strong>
-    <dd><em>hid_t</em> <code>H5Acreate</code>(<em>hid_t</em> <code>loc_id</code>,
+    <dd><font size="-1"><em>hid_t</em> <code>H5Acreate</code>(<em>hid_t</em> <code>loc_id</code>,
         <em>const char *</em><code>name</code>,
         <em>hid_t</em> <code>type_id</code>,
         <em>hid_t</em> <code>space_id</code>,
-        <em>hid_t</em> <code>create_plist</code>
+        <em>hid_t</em> <code>create_plist</code></font>
     )
 <dt><strong>Purpose:</strong>
     <dd>Creates a dataset as an attribute of another group, dataset, 
@@ -235,109 +277,82 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
         is currently unused;
         it may be used in the future for optional attribute properties.  
         At this time, <code>H5P_DEFAULT</code> is the only accepted value.
-        <p>
+        </p>
         The attribute identifier returned from this function must be released 
         with <code>H5Aclose</code> or resource leaks will develop.  
 <dt><strong>Parameters:</strong>
     <dl>
-        <dt><em>hid_t</em> <code>loc_id</code>
-            <dd>IN: Object (dataset, group, or named datatype) to be attached to.
-        <dt><em>const char *</em><code>name</code>
-            <dd>IN: Name of attribute to create.
-        <dt><em>hid_t</em> <code>type_id</code>
-            <dd>IN: Identifier of datatype for attribute.
-        <dt><em>hid_t</em> <code>space_id</code>
-            <dd>IN: Identifier of dataspace for attribute.
-        <dt><em>hid_t</em> <code>create_plist</code>
+        <dt><em>hid_t</em> <code>loc_id</code></dt>
+            <dd>IN: Object (dataset, group, or named datatype) to be attached to.</dd>
+        <dt><em>const char *</em><code>name</code></dt>
+            <dd>IN: Name of attribute to create.</dd>
+        <dt><em>hid_t</em> <code>type_id</code></dt>
+            <dd>IN: Identifier of datatype for attribute.</dd>
+        <dt><em>hid_t</em> <code>space_id</code></dt>
+            <dd>IN: Identifier of dataspace for attribute.</dd>
+        <dt><em>hid_t</em> <code>create_plist</code></dt>
             <dd>IN: Identifier of creation property list. (Currently unused;
-                    the only accepted value is <code>H5P_DEFAULT</code>.)
+                    the only accepted value is <code>H5P_DEFAULT</code>.)</dd>
     </dl>
 <dt><strong>Returns:</strong>
     <dd>Returns an attribute identifier if successful;
         otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5acreate_f" 
-        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
-        <!--
+			
+		<!--<dt><strong>Non-C API(s):</strong>        
         <img src="Graphics/Java.gif"> 
         <img src="Graphics/C++.gif">
         -->
+		
+<dt><strong>Fortran90 Interface:</strong> h5acreate_f
+    <dd>
+	<pre>
+SUBROUTINE h5acreate_f(obj_id, name, type_id, space_id, attr_id, &amp; hdferr, creation_prp) 
+  IMPLICIT NONE
+  INTEGER(HID_T), INTENT(IN) :: obj_id    ! Object identifier 
+  CHARACTER(LEN=*), INTENT(IN) :: name    ! Attribute name
+  INTEGER(HID_T), INTENT(IN) :: type_id   ! Attribute datatype identifier 
+  INTEGER(HID_T), INTENT(IN) :: space_id  ! Attribute dataspace identifier
+  INTEGER(HID_T), INTENT(OUT) :: attr_id  ! Attribute identifier 
+  INTEGER, INTENT(OUT) :: hdferr       ! Error code:
+                                       ! 0 on success and -1 on failure
+  INTEGER(HID_T), OPTIONAL, INTENT(IN) :: creation_prp
+                                       ! Attribute creation property 
+                                       ! list identifier 
+END SUBROUTINE h5acreate_f
+	</pre>
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aopen_name" -->
+<!-- HEADER RIGHT "H5Adelete" -->
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Annot-OpenName">H5Aopen_name</a>
+<dt><strong>Name:</strong> <a name="Annot-Delete">H5Adelete</a>
 <dt><strong>Signature:</strong>
-    <dd><em>hid_t</em> <code>H5Aopen_name</code>(<em>hid_t</em> <code>loc_id</code>,
+    <dd><em>herr_t</em> <code>H5Adelete</code>(<em>hid_t</em> <code>loc_id</code>,
         <em>const char *</em><code>name</code>
     )
 <dt><strong>Purpose:</strong>
-    <dd> Opens an attribute specified by name.
+    <dd>Deletes an attribute from a location.
 <dt><strong>Description:</strong>
-    <dd><code>H5Aopen_name</code> opens an attribute specified by 
-         its name, <code>name</code>, which is attached to the 
-         object specified with <code>loc_id</code>. 
-         The location object may be either a group, dataset, or 
-         named datatype, which may have any sort of attribute. 
-         The attribute identifier returned from this function must 
-         be released with <code>H5Aclose</code> or resource leaks 
-         will develop. 
+    <dd><code>H5Adelete</code> removes the attribute specified by its  
+        name, <code>name</code>, from a dataset, group, or named datatype. 
+        This function should not be used when attribute identifiers are 
+        open on <code>loc_id</code> as it may cause the internal indexes 
+        of the attributes to change and future writes to the open 
+        attributes to produce incorrect results. 
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>loc_id</code>
-            <dd>IN: Identifier of a group, dataset, or named datatype 
-                atttribute to be attached to.
+            <dd>IN: Identifier of the dataset, group, or named datatype 
+                to have the attribute deleted from.
         <dt><em>const char *</em><code>name</code>
-            <dd>IN: Attribute name.
-    </dl>
-<dt><strong>Returns:</strong>
-    <dd>Returns attribute identifier if successful;
-        otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aopen_name_f" 
-        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
-        <!--
-        <img src="Graphics/Java.gif"> 
-        <img src="Graphics/C++.gif">
-        -->
-</dl>
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aopen_idx" -->
-<hr>
-<dl>
-<dt><strong>Name:</strong> <a name="Annot-OpenIdx">H5Aopen_idx</a>
-<dt><strong>Signature:</strong>
-    <dd><em>hid_t</em> <code>H5Aopen_idx</code>(<em>hid_t</em> <code>loc_id</code>,
-        <em>unsigned int</em> <code>idx</code>
-    )
-<dt><strong>Purpose:</strong>
-    <dd>Opens the attribute specified by its index.
-<dt><strong>Description:</strong>
-    <dd><code>H5Aopen_idx</code> opens an attribute which is attached 
-        to the object specified with <code>loc_id</code>. 
-        The location object may be either a group, dataset, or 
-        named datatype, all of which may have any sort of attribute.  
-        The attribute specified by the index, <code>idx</code>, 
-        indicates the attribute to access.  
-        The value of <code>idx</code> is a 0-based, non-negative integer.
-        The attribute identifier returned from this function must be 
-        released with <code>H5Aclose</code> or resource leaks will develop. 
-<dt><strong>Parameters:</strong>
-    <dl>
-        <dt><em>hid_t</em> <code>loc_id</code>
-            <dd>IN: Identifier of the group, dataset, or named datatype 
-                attribute to be attached to.
-        <dt><em>unsigned int</em> <code>idx</code>
-            <dd>IN: Index of the attribute to open.
+            <dd>IN: Name of the attribute to delete.
     </dl>
 <dt><strong>Returns:</strong>
-    <dd>Returns attribute identifier if successful;
+    <dd>Returns a non-negative value if successful;
         otherwise returns a negative value.
 <dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aopen_idx_f" 
+    <dd><a href="fortran/h5a_FORTRAN.html#h5adelete_f" 
         target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
         <!--
         <img src="Graphics/Java.gif"> 
@@ -346,44 +361,40 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Awrite" -->
+<!-- HEADER RIGHT "H5Aget_name" -->
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Annot-Write">H5Awrite</a>
+<dt><strong>Name:</strong> <a name="Annot-GetName">H5Aget_name</a>
 <dt><strong>Signature:</strong>
-    <dd><em>herr_t</em> <code>H5Awrite</code>(<em>hid_t</em> <code>attr_id</code>,
-        <em>hid_t</em> <code>mem_type_id</code>,
-        <em>const void *</em><code>buf</code>
+    <dd><em>ssize_t</em> <code>H5Aget_name</code>(<em>hid_t</em> <code>attr_id</code>,
+        <em>size_t</em> <code>buf_size</code>,
+        <em>char *</em><code>buf</code>
     )
 <dt><strong>Purpose:</strong>
-    <dd>Writes data to an attribute.
+    <dd>Gets an attribute name.
 <dt><strong>Description:</strong>
-    <dd><code>H5Awrite</code> writes an attribute, specified with 
-        <code>attr_id</code>.  The attribute's memory datatype 
-        is specified with <code>mem_type_id</code>.  The entire 
-        attribute is written from <code>buf</code> to the file. 
-        <p>
-        Datatype conversion takes place at the time of a read or write
-        and is automatic.  See the
-        <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> 
-        section of <cite>The Data Type Interface (H5T)</cite> in the 
-        <cite>HDF5 User's Guide</cite> for a discussion of 
-        data conversion, including the range of conversions currently 
-        supported by the HDF5 libraries.
+    <dd><code>H5Aget_name</code> retrieves the name of an attribute 
+        specified by the identifier, <code>attr_id</code>.
+        Up to <code>buf_size</code> characters are stored in 
+        <code>buf</code> followed by a <code>\0</code> string
+        terminator.  If the name of the attribute is longer than 
+        <code>(buf_size -1)</code>, the string terminator is stored in the
+        last position of the buffer to properly terminate the string.
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>attr_id</code>
-            <dd>IN: Identifier of an attribute to write.
-        <dt><em>hid_t</em> <code>mem_type_id</code>
-            <dd>IN: Identifier of the attribute datatype (in memory).
-        <dt><em>const void *</em><code>buf</code>
-            <dd>IN: Data to be written.
+            <dd>IN: Identifier of the attribute.
+        <dt><em>size_t</em> <code>buf_size</code>
+            <dd>IN: The size of the buffer to store the name in.
+        <dt><em>char *</em><code>buf</code>
+            <dd>IN: Buffer to store name in.
     </dl>
 <dt><strong>Returns:</strong>
-    <dd>Returns a non-negative value if successful;
-        otherwise returns a negative value.
+    <dd>Returns the length of the attribute's name, which may be
+        longer than <code>buf_size</code>, if successful.
+        Otherwise returns a negative value.
 <dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5awrite_f" 
+    <dd><a href="fortran/h5a_FORTRAN.html#h5aget_name_f" 
         target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
         <!--
         <img src="Graphics/Java.gif"> 
@@ -392,44 +403,29 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aread" -->
+<!-- HEADER RIGHT "H5Aget_num_attrs" -->
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Annot-Read">H5Aread</a>
+<dt><strong>Name:</strong> <a name="Annot-NumAttrs">H5Aget_num_attrs</a>
 <dt><strong>Signature:</strong>
-    <dd><em>herr_t</em> <code>H5Aread</code>(<em>hid_t</em> <code>attr_id</code>,
-        <em>hid_t</em> <code>mem_type_id</code>,
-        <em>void *</em><code>buf</code>
-    )
+    <dd><em>int</em> <code>H5Aget_num_attrs</code>(<em>hid_t</em> <code>loc_id</code>)
 <dt><strong>Purpose:</strong>
-    <dd>Reads an attribute.
+    <dd>Determines the number of attributes attached to an object.
 <dt><strong>Description:</strong>
-    <dd><code>H5Aread</code> reads an attribute, specified with 
-        <code>attr_id</code>.  The attribute's memory datatype 
-        is specified with <code>mem_type_id</code>.  The entire 
-        attribute is read into <code>buf</code> from the file. 
-        <p>
-        Datatype conversion takes place at the time of a read or write
-        and is automatic.  See the
-        <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> 
-        section of <cite>The Data Type Interface (H5T)</cite> in the 
-        <cite>HDF5 User's Guide</cite> for a discussion of 
-        data conversion, including the range of conversions currently 
-        supported by the HDF5 libraries.
+    <dd><code>H5Aget_num_attrs</code> returns the number of attributes 
+        attached to the object specified by its identifier, 
+        <code>loc_id</code>.  
+        The object can be a group, dataset, or named datatype.
 <dt><strong>Parameters:</strong>
     <dl>
-        <dt><em>hid_t</em> <code>attr_id</code>
-            <dd>IN: Identifier of an attribute to read.
-        <dt><em>hid_t</em> <code>mem_type_id</code>
-            <dd>IN: Identifier of the attribute datatype (in memory).
-        <dt><em>void *</em><code>buf</code>
-            <dd>OUT: Buffer for data to be read.
+        <dt><em>hid_t</em> <code>loc_id</code>
+            <dd>IN: Identifier of a group, dataset, or named datatype.
     </dl>
 <dt><strong>Returns:</strong>
-    <dd>Returns a non-negative value if successful;
+    <dd>Returns the number of attributes if successful;
         otherwise returns a negative value.
 <dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aread_f" 
+    <dd><a href="fortran/h5a_FORTRAN.html#h5aget_num_attrs_f" 
         target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
         <!--
         <img src="Graphics/Java.gif"> 
@@ -506,79 +502,6 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aget_name" -->
-<hr>
-<dl>
-<dt><strong>Name:</strong> <a name="Annot-GetName">H5Aget_name</a>
-<dt><strong>Signature:</strong>
-    <dd><em>ssize_t</em> <code>H5Aget_name</code>(<em>hid_t</em> <code>attr_id</code>,
-        <em>size_t</em> <code>buf_size</code>,
-        <em>char *</em><code>buf</code>
-    )
-<dt><strong>Purpose:</strong>
-    <dd>Gets an attribute name.
-<dt><strong>Description:</strong>
-    <dd><code>H5Aget_name</code> retrieves the name of an attribute 
-        specified by the identifier, <code>attr_id</code>.
-        Up to <code>buf_size</code> characters are stored in 
-        <code>buf</code> followed by a <code>\0</code> string
-        terminator.  If the name of the attribute is longer than 
-        <code>(buf_size -1)</code>, the string terminator is stored in the
-        last position of the buffer to properly terminate the string.
-<dt><strong>Parameters:</strong>
-    <dl>
-        <dt><em>hid_t</em> <code>attr_id</code>
-            <dd>IN: Identifier of the attribute.
-        <dt><em>size_t</em> <code>buf_size</code>
-            <dd>IN: The size of the buffer to store the name in.
-        <dt><em>char *</em><code>buf</code>
-            <dd>IN: Buffer to store name in.
-    </dl>
-<dt><strong>Returns:</strong>
-    <dd>Returns the length of the attribute's name, which may be
-        longer than <code>buf_size</code>, if successful.
-        Otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aget_name_f" 
-        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
-        <!--
-        <img src="Graphics/Java.gif"> 
-        <img src="Graphics/C++.gif">
-        -->
-</dl>
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aget_num_attrs" -->
-<hr>
-<dl>
-<dt><strong>Name:</strong> <a name="Annot-NumAttrs">H5Aget_num_attrs</a>
-<dt><strong>Signature:</strong>
-    <dd><em>int</em> <code>H5Aget_num_attrs</code>(<em>hid_t</em> <code>loc_id</code>)
-<dt><strong>Purpose:</strong>
-    <dd>Determines the number of attributes attached to an object.
-<dt><strong>Description:</strong>
-    <dd><code>H5Aget_num_attrs</code> returns the number of attributes 
-        attached to the object specified by its identifier, 
-        <code>loc_id</code>.  
-        The object can be a group, dataset, or named datatype.
-<dt><strong>Parameters:</strong>
-    <dl>
-        <dt><em>hid_t</em> <code>loc_id</code>
-            <dd>IN: Identifier of a group, dataset, or named datatype.
-    </dl>
-<dt><strong>Returns:</strong>
-    <dd>Returns the number of attributes if successful;
-        otherwise returns a negative value.
-<dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aget_num_attrs_f" 
-        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
-        <!--
-        <img src="Graphics/Java.gif"> 
-        <img src="Graphics/C++.gif">
-        -->
-</dl>
-
-<!-- NEW PAGE -->
 <!-- HEADER RIGHT "H5Aiterate" -->
 <hr>
 <dl>
@@ -652,36 +575,79 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Adelete" -->
+<!-- HEADER RIGHT "H5Aopen_idx" -->
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Annot-Delete">H5Adelete</a>
+<dt><strong>Name:</strong> <a name="Annot-OpenIdx">H5Aopen_idx</a>
 <dt><strong>Signature:</strong>
-    <dd><em>herr_t</em> <code>H5Adelete</code>(<em>hid_t</em> <code>loc_id</code>,
+    <dd><em>hid_t</em> <code>H5Aopen_idx</code>(<em>hid_t</em> <code>loc_id</code>,
+        <em>unsigned int</em> <code>idx</code>
+    )
+<dt><strong>Purpose:</strong>
+    <dd>Opens the attribute specified by its index.
+<dt><strong>Description:</strong>
+    <dd><code>H5Aopen_idx</code> opens an attribute which is attached 
+        to the object specified with <code>loc_id</code>. 
+        The location object may be either a group, dataset, or 
+        named datatype, all of which may have any sort of attribute.  
+        The attribute specified by the index, <code>idx</code>, 
+        indicates the attribute to access.  
+        The value of <code>idx</code> is a 0-based, non-negative integer.
+        The attribute identifier returned from this function must be 
+        released with <code>H5Aclose</code> or resource leaks will develop. 
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>loc_id</code>
+            <dd>IN: Identifier of the group, dataset, or named datatype 
+                attribute to be attached to.
+        <dt><em>unsigned int</em> <code>idx</code>
+            <dd>IN: Index of the attribute to open.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns attribute identifier if successful;
+        otherwise returns a negative value.
+<dt><strong>Non-C API(s):</strong>
+    <dd><a href="fortran/h5a_FORTRAN.html#h5aopen_idx_f" 
+        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
+        <!--
+        <img src="Graphics/Java.gif"> 
+        <img src="Graphics/C++.gif">
+        -->
+</dl>
+
+<!-- NEW PAGE -->
+<!-- HEADER RIGHT "H5Aopen_name" -->
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Annot-OpenName">H5Aopen_name</a>
+<dt><strong>Signature:</strong>
+    <dd><em>hid_t</em> <code>H5Aopen_name</code>(<em>hid_t</em> <code>loc_id</code>,
         <em>const char *</em><code>name</code>
     )
 <dt><strong>Purpose:</strong>
-    <dd>Deletes an attribute from a location.
+    <dd> Opens an attribute specified by name.
 <dt><strong>Description:</strong>
-    <dd><code>H5Adelete</code> removes the attribute specified by its  
-        name, <code>name</code>, from a dataset, group, or named datatype. 
-        This function should not be used when attribute identifiers are 
-        open on <code>loc_id</code> as it may cause the internal indexes 
-        of the attributes to change and future writes to the open 
-        attributes to produce incorrect results. 
+    <dd><code>H5Aopen_name</code> opens an attribute specified by 
+         its name, <code>name</code>, which is attached to the 
+         object specified with <code>loc_id</code>. 
+         The location object may be either a group, dataset, or 
+         named datatype, which may have any sort of attribute. 
+         The attribute identifier returned from this function must 
+         be released with <code>H5Aclose</code> or resource leaks 
+         will develop. 
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>loc_id</code>
-            <dd>IN: Identifier of the dataset, group, or named datatype 
-                to have the attribute deleted from.
+            <dd>IN: Identifier of a group, dataset, or named datatype 
+                atttribute to be attached to.
         <dt><em>const char *</em><code>name</code>
-            <dd>IN: Name of the attribute to delete.
+            <dd>IN: Attribute name.
     </dl>
 <dt><strong>Returns:</strong>
-    <dd>Returns a non-negative value if successful;
+    <dd>Returns attribute identifier if successful;
         otherwise returns a negative value.
 <dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5adelete_f" 
+    <dd><a href="fortran/h5a_FORTRAN.html#h5aopen_name_f" 
         target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
         <!--
         <img src="Graphics/Java.gif"> 
@@ -690,30 +656,44 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
 </dl>
 
 <!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Aclose" -->
+<!-- HEADER RIGHT "H5Aread" -->
 <hr>
 <dl>
-<dt><strong>Name:</strong> <a name="Annot-Close">H5Aclose</a>
+<dt><strong>Name:</strong> <a name="Annot-Read">H5Aread</a>
 <dt><strong>Signature:</strong>
-    <dd><em>herr_t</em> <code>H5Aclose</code>(<em>hid_t</em> <code>attr_id</code>)
+    <dd><em>herr_t</em> <code>H5Aread</code>(<em>hid_t</em> <code>attr_id</code>,
+        <em>hid_t</em> <code>mem_type_id</code>,
+        <em>void *</em><code>buf</code>
+    )
 <dt><strong>Purpose:</strong>
-    <dd>Closes the specified attribute.
+    <dd>Reads an attribute.
 <dt><strong>Description:</strong>
-    <dd><code>H5Aclose</code> terminates access to the attribute 
-        specified by <code>attr_id</code> by releasing the identifier.
+    <dd><code>H5Aread</code> reads an attribute, specified with 
+        <code>attr_id</code>.  The attribute's memory datatype 
+        is specified with <code>mem_type_id</code>.  The entire 
+        attribute is read into <code>buf</code> from the file. 
         <p>
-        Further use of a released attribute identifier is illegal; 
-        a function using such an identifier will fail.
+        Datatype conversion takes place at the time of a read or write
+        and is automatic.  See the
+        <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> 
+        section of <cite>The Data Type Interface (H5T)</cite> in the 
+        <cite>HDF5 User's Guide</cite> for a discussion of 
+        data conversion, including the range of conversions currently 
+        supported by the HDF5 libraries.
 <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>attr_id</code>
-            <dd>IN: Attribute to release access to.
+            <dd>IN: Identifier of an attribute to read.
+        <dt><em>hid_t</em> <code>mem_type_id</code>
+            <dd>IN: Identifier of the attribute datatype (in memory).
+        <dt><em>void *</em><code>buf</code>
+            <dd>OUT: Buffer for data to be read.
     </dl>
 <dt><strong>Returns:</strong>
     <dd>Returns a non-negative value if successful;
         otherwise returns a negative value.
 <dt><strong>Non-C API(s):</strong>
-    <dd><a href="fortran/h5a_FORTRAN.html#h5aclose_f" 
+    <dd><a href="fortran/h5a_FORTRAN.html#h5aread_f" 
         target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
         <!--
         <img src="Graphics/Java.gif"> 
@@ -721,6 +701,51 @@ See <a href="Attributes.html"><cite>Attributes</cite></a> in the
         -->
 </dl>
 
+<!-- NEW PAGE -->
+<!-- HEADER RIGHT "H5Awrite" -->
+<hr>
+<dl>
+<dt><strong>Name:</strong> <a name="Annot-Write">H5Awrite</a>
+<dt><strong>Signature:</strong>
+    <dd><em>herr_t</em> <code>H5Awrite</code>(<em>hid_t</em> <code>attr_id</code>,
+        <em>hid_t</em> <code>mem_type_id</code>,
+        <em>const void *</em><code>buf</code>
+    )
+<dt><strong>Purpose:</strong>
+    <dd>Writes data to an attribute.
+<dt><strong>Description:</strong>
+    <dd><code>H5Awrite</code> writes an attribute, specified with 
+        <code>attr_id</code>.  The attribute's memory datatype 
+        is specified with <code>mem_type_id</code>.  The entire 
+        attribute is written from <code>buf</code> to the file. 
+        <p>
+        Datatype conversion takes place at the time of a read or write
+        and is automatic.  See the
+        <a href="Datatypes.html#Datatypes-DataConversion">Data Conversion</a> 
+        section of <cite>The Data Type Interface (H5T)</cite> in the 
+        <cite>HDF5 User's Guide</cite> for a discussion of 
+        data conversion, including the range of conversions currently 
+        supported by the HDF5 libraries.
+<dt><strong>Parameters:</strong>
+    <dl>
+        <dt><em>hid_t</em> <code>attr_id</code>
+            <dd>IN: Identifier of an attribute to write.
+        <dt><em>hid_t</em> <code>mem_type_id</code>
+            <dd>IN: Identifier of the attribute datatype (in memory).
+        <dt><em>const void *</em><code>buf</code>
+            <dd>IN: Data to be written.
+    </dl>
+<dt><strong>Returns:</strong>
+    <dd>Returns a non-negative value if successful;
+        otherwise returns a negative value.
+<dt><strong>Non-C API(s):</strong>
+    <dd><a href="fortran/h5a_FORTRAN.html#h5awrite_f" 
+        target="FortranWin"><img src="Graphics/FORTRAN.gif" border=0></a>
+        <!--
+        <img src="Graphics/Java.gif"> 
+        <img src="Graphics/C++.gif">
+        -->
+</dl>
 
 <!-- #BeginLibraryItem "/ed_libs/NavBar_RM.lbi" --><hr>
 <center>
@@ -755,8 +780,7 @@ And in this document, the
 </td></tr>
 </table>
 </center>
-<hr>
-<!-- #EndLibraryItem --><!-- #BeginLibraryItem "/ed_libs/Footer.lbi" --><address>
+<hr><!-- #EndLibraryItem --><!-- #BeginLibraryItem "/ed_libs/Footer.lbi" --><address>
 <a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a> 
 <br>
 Describes HDF5 Release 1.6.0, July 2003