[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, 8 insertions, 56 deletions

diff --git a/doc/html/Groups.html b/doc/html/Groups.html
index a313f6c..d6999d9 100644
--- a/doc/html/Groups.html
+++ b/doc/html/Groups.html
@@ -51,7 +51,7 @@
       name which begins with a slash is an <em>absolute</em> name
       which is looked up beginning at the root group of the file while
       all other <em>relative</em> names are looked up beginning at the
-      current working group (described below) or a specified group.
+      specified group.
       Multiple consecutive slashes in a full name are treated as
       single slashes and trailing slashes are not significant.  A
       special case is the name "/" (or equivalent) which refers to the
@@ -104,9 +104,7 @@
 	    <td>File ID</td>
 	    <td><code>foo/bar</code></td>
 	    <td>The object <code>bar</code> in group <code>foo</code>
-	      in the current working group of the specified file.  The
-	      initial current working group is the root group of the
-	      file as described below.</td>
+	      in the specified group.</td>
 	  </tr>
 
 	  <tr>
@@ -119,7 +117,7 @@
 	  <tr>
 	    <td>File ID</td>
 	    <td><code>.</code></td>
-	    <td>The current working group of the specified file.</td>
+	    <td>The specified file.</td>
 	  </tr>
 
 	  <tr>
@@ -181,51 +179,7 @@
 	returns zero for success or a negative value for failure.
     </dl>
 
-    <h2>4. Current Working Group</h2>
-
-    <p>Each file handle (<code>hid_t <em>file_id</em></code>) has a
-      current working group, initially the root group of the file.
-      Names which do not begin with a slash are relative to the
-      specified group or to the current working group as described
-      above.  For instance, the name "/Foo/Bar/Baz" is resolved by
-      first looking up "Foo" in the root group.  But the name
-      "Foo/Bar/Baz" is resolved by first looking up "Foo" in the
-      current working group.
-
-    <dl>
-      <dt><code>herr_t H5Gset (hid_t <em>location_id</em>, const char
-	  *<em>name</em>)</code>
-      <dd>The group with the specified name is made the current
-	working group for the file which contains it. The
-	<em>location_id</em> can be a file handle or a group handle
-	and the name is resolved as described above.  Each file handle
-	has it's own current working group and if the
-	<em>location_id</em> is a group handle then the file handle is
-	derived from the group handle. This function returns zero for
-	success or negative for failure.
-
-	<br><br>
-      <dt><code>herr_t H5Gpush (hid_t <em>location_id</em>, const char
-	  *<em>name</em>)</code>
-      <dd>Each file handle has a stack of groups and the top group on
-	that stack is the current working group.  The stack initially
-	contains only the root group.  This function pushes a new
-	group onto the stack and returns zero for success or negative
-	for failure.
-
-	<br><br>
-      <dt><code>herr_t H5Gpop (hid_t <em>location_id</em>)</code>
-      <dd>This function pops one group off the group stack for the
-	specified file (if the <em>location_id</em> is a group then
-	the file is derived from that group), changing the current
-	working group to the new top-of-stack group.  The function
-	returns zero for success or negative for failure (failure
-	includes attempting to pop from an empty stack).  If the last
-	item is popped from the stack then the current working group
-	is set to the root group.
-    </dl>
-
-    <h2>5. Objects with Multiple Names</h2>
+    <h2>4. Objects with Multiple Names</h2>
 
     <p>An object (including a group) can have more than one
       name. Creating the object gives it the first name, and then
@@ -263,8 +217,7 @@
 	<code>H5T_LINK_SOFT</code> a soft link is created which is an
 	alias for the <em>current_name</em>.  When creating a soft
 	link the object need not exist.  This function returns zero
-	for success or negative for failure. <b>This function is not
-	part of the prototype API.</b>
+	for success or negative for failure. 
 
 	<br><br>
       <dt><code>herr_t H5Gunlink (hid_t <em>file_id</em>, const char
@@ -274,11 +227,10 @@
 	to the object and when the hard link count reaches zero the
 	object can be removed from the file (but objects which are
 	open are not removed until all handles to the object are
-	closed).  <b>This function is not part of the prototype
-	API.</b>
+	closed).  
     </dl>
 
-    <h2>6. Comments</h2>
+    <h2>5. Comments</h2>
 
     <p>Objects can have a comment associated with them.  The comment
       is set and queried with these two functions:
@@ -320,7 +272,7 @@ Last modified: Wed Jul 22 14:24:34 EDT 1998
 <a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
 </address>
 
-Last modified:  9 September 1998
+Last modified:  29 October 1998
 
   </body>
 </html>