[svn-r830] ======

Intro
======
H5.intro.html
	Major rewrite to Groups section.  New Example 7 (groups).
	Added TOC and requisite links.
	Numbered sections.
	Labelled figures and centered those that were not.
	Fixed table formatting.

===========
User Guide
===========
H5.user.html
	Linked in Chunking.html.
	Linked in References.html.
	Linked in DDL.html.

Chunking.html
        Minor edits.

DDL.html
References.html
	New documents.

Datatypes.html
	Added "R Reference" to base name description and
	   "H5T_STD_ROBJ -- Reference to an entire object
	   in a file" to list of datatype names.

Files.html
	H5Fflush
	   Added scope parameter.

Groups.html
	Removed references to "current working group."
	Removed H5Gpush, H5Gpop, and H5Gset functions.
        Removed note that H5Glink and H5Gunlink were not implemented.

=================
Reference Manual
=================
RM_*.html and Tools.html
	Updated Reference Manual internal cross-linking (the link
	   banner at the top and bottom of each page).
	Changed
		Returns SUCCEED (0) if successful;
		otherwise FAIL (-1).
	   to read
		Returns a non-negative value if successful;
		otherwise returns a negative value.
	   and several derived changes where circumstances differred
	   only slightly.
	Minor copy edits throughout.

RM_H5.html
	Corrected H5open "Purpose" statement.

RM_H5A.html
	Changed H5Aget_name return type to hssize_t.

RM_H5F.html
	H5Fflush
	   Added scope parameter.
        Added H5Freopen.

RM_H5Front.html
	Reordered listing of interfaces to alphabetical order (H5,
	   H5A, H5D, ...)
 	Added H5I, H5R, and H5RA.

RM_H5G.html
	H5Gopen
	   Edited "Description."
	H5Gget_objinfo
	   Added named datatype to list of valid values for loc_id.

RM_H5I.html  Identifier Interface
	New section.

RM_H5P.html
	Added H5Pset_fill_value and H5Pget_fill_value.
        Several minor copy edits.

RM_H5R.html  Reference Interface
	New section.

H5RA.html
	Essentially a new section.  It was in the tree previously,
	but it did not actually have content.

RM_H5S.html
	Changed H5Sget_select_npoints return type to hssize_t.

Tools.html
	Updated h5dump documentation.

1 files changed, 64 insertions, 39 deletions

diff --git a/doc/html/Tools.html b/doc/html/Tools.html
index bf44249..06aa2b7 100644
--- a/doc/html/Tools.html
+++ b/doc/html/Tools.html
@@ -14,10 +14,10 @@ HDF5/Tools Draft API Specification
 <a href="RM_H5E.html">H5E</a>&nbsp;&nbsp;
 <a href="RM_H5F.html">H5F</a>&nbsp;&nbsp;
 <a href="RM_H5G.html">H5G</a>&nbsp;&nbsp;
+<a href="RM_H5I.html">H5I</a>&nbsp;&nbsp;
 <a href="RM_H5P.html">H5P</a>&nbsp;&nbsp;
-<!--
+<a href="RM_H5R.html">H5R</a>&nbsp;&nbsp;
 <a href="RM_H5RA.html">H5RA</a>&nbsp;&nbsp;
--->
 <a href="RM_H5S.html">H5S</a>&nbsp;&nbsp;
 <a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
 <a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
@@ -64,40 +64,56 @@ These tools enable the user to examine HDF5 files interactively.
         [-a </code><em>names</em><code>]
         [-d </code><em>names</em><code>]
         [-g </code><em>names</em><code>]
-        [-l </code><em>names</em><code>] </code>
+        [-l </code><em>names</em><code>]
+        [-t </code><em>names</em><code>] </code>
         <em>file</em>
 <dt><strong>Purpose:</strong>
     <dd>Displays HDF5 file contents.
 <dt><strong>Description:</strong>
     <dd><code>h5dump</code> enables the user to interactively examine 
         the contents of an HDF5 file and dump those contents, 
-        in human readable form, to an ASCII file or to other tools.
+        in human readable form, to an ASCII file.
         <p>
         <code>h5dump</code> displays HDF5 file content on 
         standard output.  It may display the content of the 
         whole HDF5 file or selected objects, which can be groups, 
-        datasets, links, or attributes. 
+        datasets, links, attributes, or data types. 
         <p>
         The <code>-header</code> option displays object 
-        header information only and must appear before the 
-        <code>-a</code>, <code>-d</code>, <code>-g</code>, or 
-        <code>-l</code> options. 
+        header information only.
+        <p>
+        Names are the absolute names of the objects. 
+        <code>h5dump</code> displays objects in the order same as the
+        command order.  If a name does not start with a slash, 
+        <code>h5dump</code> begins searching for the specified object 
+        starting at the root group.
         <p>
-        Native data types created in one machine are displayed with native
-        names when <code>h5dump</code> runs in the same machine type. But when 
-        <code>h5dump</code> runs in a different machine type, it displays the 
-        native data types with standard type names. This will be changed in the 
-        next release to always display with standard type names.
+        If an object is hard linked with multiple names, 
+        <code>h5dump</code> displays the content of the object in the
+        first occurrence. Only the link information is displayed in 
+        later occurrences.
         <p>
-        The <code>h5dump</code> output is described in detail in 
-        <a href="../html/ddl.html">DDL</a>, the <cite>Data Description 
-        Language</cite> document. 
+        <code>h5dump</code> assigns a name for any unnamed data type in
+        the form of <code>#</code><em>oid1</em><code>:</code><em>oid2</em>,
+        where <em>oid1</em> and <em>oid2</em> are the object identifiers
+        assigned by the library. The unnamed types are displayed within
+        the root group.
+        <p>
+        Data types are displayed with standard type names. For example,
+        if a data set is created with <code>H5T_NATIVE_INT</code> type
+        and the standard type name for integer on that machine is
+        <code>H5T_STD_I32BE</code>, <code>h5dump</code> displays
+        <code>H5T_STD_I32BE</code> as the type of the data set.            
+        <p>
+        The <code>h5dump</code> output is described in detail in the
+        <a href="DDL.html"><cite>DDL for HDF5</cite></a>, the 
+        <cite>Data Description Language</cite> document. 
 <dt><strong>Options and Parameters:</strong>
     <dl>
         <dt><code>-h</code>
-            <dd>Print information on this command.
+            <dd>Prints information on this command.
         <dt><code>-bb</code>
-            <dd>Displays the content of boot block. The default is 
+            <dd>Displays the contents of the boot block. The default is 
                 not to display.
         <dt><code>-header</code>
             <dd>Displays header information only; no data is displayed.
@@ -106,35 +122,44 @@ These tools enable the user to examine HDF5 files interactively.
         <dt><code>-d</code> <em>names</em>
             <dd>Displays the specified dataset(s).
         <dt><code>-g</code> <em>names</em>
-            <dd>Displays all the objects within the specified group(s).
+            <dd>Displays the specified group(s) and all the members.
         <dt><code>-l</code> <em>names</em>
-            <dd>Displays the specified link value(s).
+            <dd>Displays the values of the specified soft link(s).
+        <dt><code>-t</code> <em>names</em>
+            <dd>Displays the specified named data type(s).
         <dt><em>file</em>
             <dd>The file to be examined.
     </dl>
 <dt><strong>Current Status:</strong>
-    <dd>The current version of <code>h5dump</code> can display the
-        following types of information:
+    <dd>The current version of <code>h5dump</code> displays the
+        following information:
+        <ul>
+        <li>Group
         <ul>
-          <li>Group name
-          <li>Attribute name, data type, data space, and data
-          <li>Dataset name, data type, data space, and data
-          <li>Soft link name, link value
+           <li>group attributes
+           <li>group member
         </ul>
-
-        <dd>Limitions in the current implementaion include the
-            following:
+        <li>Dataset
+        <ul>
+           <li>dataset attributes
+           <li>data type
+           <li>data space
+           <li>data
+        </ul>
+        <li>Data type
         <ul>
-          <li>Only one file is displayed at a time (file families are 
-              not supported).
-          <li>The whole file content is displayed (none of above 
-              options are supported).
-          <li>Compound data types are not yet supported.
-          <li>Complex data spaces are not yet supported.
+           <li>scalar type
+           <li>transient type
+           <li>named type
+           <li>unnamed type
+        </ul>
+        <li>Simple data space
+        <li>Soft link
+        <li>Hard link
         </ul>
 <dt><strong>See Also:</strong>
     <dd>HDF5 Data Description Language syntax 
-        (<a href="../html/ddl.html">DDL</a>)
+        (<a href="DDL.html"><cite>DDL for HDF5</cite></a>)
 </dl>
 
 
@@ -241,10 +266,10 @@ These tools enable the user to examine HDF5 files interactively.
 <a href="RM_H5E.html">H5E</a>&nbsp;&nbsp;
 <a href="RM_H5F.html">H5F</a>&nbsp;&nbsp;
 <a href="RM_H5G.html">H5G</a>&nbsp;&nbsp;
+<a href="RM_H5I.html">H5I</a>&nbsp;&nbsp;
 <a href="RM_H5P.html">H5P</a>&nbsp;&nbsp;
-<!--
+<a href="RM_H5R.html">H5R</a>&nbsp;&nbsp;
 <a href="RM_H5RA.html">H5RA</a>&nbsp;&nbsp;
--->
 <a href="RM_H5S.html">H5S</a>&nbsp;&nbsp;
 <a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
 <a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
@@ -259,7 +284,7 @@ Tools&nbsp;&nbsp;
 <a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
 
 <br>
-Last modified:  9 September 1998
+Last modified:  27 October 1998
 
 </body>
 </html>