[svn-r546] Changes since 19980724

----------------------

./MANIFEST
./doc/html/H5.format.html
./src/H5O.c
./src/H5Oprivate.h
./src/H5Omtime.c	[NEW]
./src/H5private.h
./src/Makefile.in
	Added the modification time message.  If an object header has
	this message then it's value is updated with the current time
	whenever anything changes in the object header.

./acconfig.h
./configure.in
	Alas, there seems to be no standard way to convert a string
	time like 19980727122800 in UTC to a time_t since mktime()
	only converts local times to time_t.  So I've modified the
	configuration to check for various ways of getting the time
	zone information:

	   * Added checks for the `tm_gmtoff' field of `struct tm'.
	   * Added a check for the `timezone' global variable.
	   * Added a check for `struct timezone'.
	   * Added a check for BSDgettimeofday().
	   * Added a check for gettimeofday() although it doesn't
	     actually set the timezone argument on some systems.
	   * Added a check to see if `tm_zone' is a member of `struct tm'.
	   * Added a check to see if `tzname' is a global variable.
	   * Added a check to see if `struct tm' is defined in time.h
	     or sys/time.h.

	It's not difficult to get the right UTC modification message
	into the object header, but some systems might have problems
	getting the right time back out (Irix64 is one) and those
	systems will report zero for the H5G_stat_t.mtime from an
	H5Gstat() call as if the mtime message isn't even present.  It
	will, however, continue to be updated as normal.

./src/H5G.c
./src/H5Gpublic.h
	The H5G_stat_t struct now contains an `mtime' field which will
	hold the object modification time.  If the object has no
	object modification time then the `mtime' will be initialized
	to zero.

	Fixed a bug in H5G_stat() that caused the `objno' field of the
	H5G_stat_t to be set incorrectly on some machines.

./src/H5D.c
	Writing to external datasets fail if the hdf5 file is not open
	for writing.

	A modification time message is added to the dataset object
	header when it's created and H5O_touch() is called from
	H5D_write() to update that message.

./src/H5T.c
	Fixed a bug in H5Tget_member_dims() that caused a segmentation
	fault if one of the output array arguments was the null
	pointer.

	Relaxed the member dimension checking in H5Tinsert_array() so
	it can also be used for scalar members.

./test/Makefile.in
	Added additional file names to the `mostlyclean' target.

./tools/h5dump.c
./tools/h5tools.h
	Increased the temporary buffer size to 1MB.

	Added support for printing compound data types with array
	members.

	When printing H5T_NATIVE_CHAR and H5T_NATIVE_UCHAR we escape
	double quote characters.

./tools/h5ls.c
	Changed the output format a little because we were starting to
	get too much info to fit on a line.  Without `--verbose' each
	object occupies one line of output.  Otherwise, additional
	information is printed below the object name: object file
	address, comment, and modification time.  If `--dump' is given
	then the data is printed after the other information.

./test/cmpd_dset.c
	Changed the way the dataset is initialized to be more uniform.

1 files changed, 146 insertions, 31 deletions

diff --git a/doc/html/H5.format.html b/doc/html/H5.format.html
index 3dd2bc5..7813856 100644
--- a/doc/html/H5.format.html
+++ b/doc/html/H5.format.html
@@ -2716,8 +2716,6 @@
       associated with any type of object which has an object header
       (groups, datasets, named types and spaces, etc.).
 
-    <p><b>Format of Data:</b>
-    
     <p>
     <center>
       <table border align=center cellpadding=4 width="80%">
@@ -2838,36 +2836,153 @@
     
     <hr>
     <h3><a name="NameMessage">Name: Object Name</a></h3>
-    <b>Type:</b> 0x000D<BR>
-    <b>Length:</b> varies<BR>
-    <b>Status:</b> Optional [required?], may not be repeated.<BR>
-    <b>Purpose and Description:</b>  The object name is designed to be a short
-    description of the instance of the data object (the class may be a short
-    description of the "type" of the object).  An object name is a sequence of
-    non-zero ('\0') ASCII characters with no other formatting included by the
-    library.<BR>
-    <b>Format of Data:</b>The data for the object name is just a sequence of ASCII
-    characters with no special formatting.
+
+    <p><b>Type:</b> 0x000D<br>
+      <b>Length:</b> varies<br>
+      <b>Status:</b> Optional, may not be repeated.
+
+    <p><b>Purpose and Description:</b> The object name or comment is
+      designed to be a short description of an object.  An object name
+      is a sequence of non-zero ('\0') ASCII characters with no other
+      formatting included by the library.
+
+    <p>
+    <center>
+      <table border align=center cellpadding=4 width="80%">
+	<caption align=top>
+	  <b>Name Message</b>
+	</caption>
+
+	<tr align=center>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	</tr>
+
+	<tr align=center>
+	  <td colspan=4><br>Name<br><br></td>
+	</tr>
+      </table>
+    </center>
+
+    <p>
+    <center>
+      <table align=center width="80%">
+	<tr>
+	  <th width="30%">Field Name</th>
+	  <th width="70%">Description</th>
+	</tr>
+
+	<tr valign=top>
+	  <td>Name</td>
+	  <td>A null terminated ASCII character string.</td>
+	</tr>
+      </table>
+    </center>
     
     <hr>
-    <h3><a name="ModifiedMessage">Name: Object Modification Date &amp; Time</a></h3>
-    <b>Type:</b> 0x000E<BR>
-    <b>Length:</b> fixed<BR>
-    <b>Status:</b> Required?, may not be repeated.<BR>
-    <b>Purpose and Description:</b>  The object modification date and time is a
-    timestamp which indicates (using ISO8601 date and time format) the last
-    modification of a data object.<BR>
-    <b>Format of Data:</b>
-    The date is represented as a fixed length ASCII string according to the
-    "complete calendar date representation, without hyphens" listed in the ISO8601
-    standard.<br>
-    The time of day is represented as a fixed length ASCII string according
-    to the "complete local time of day representation, without hyphens"
-    listed in the ISO8601 standard.
-    
-    <h4><a name="ModifiedExample">Examples:</a></h4>
-    "February 14, 1993, 1:10pm and 30 seconds" is represented as "19930214131030" in
-    the ISO standard format.
+    <h3><a name="ModifiedMessage">Name: Object Modification Date &amp;
+	Time</a></h3>
+
+    <p><b>Type:</b> 0x000E<br>
+      <b>Length:</b> fixed<br>
+      <b>Status:</b> Optional, may not be repeated.
+
+    <p><b>Purpose and Description:</b>  The object modification date
+      and time is a timestamp which indicates (using ISO-8601 date and
+      time format) the last modification of an object.  The time is
+      updated when any object header message changes according to the
+      system clock where the change was posted.
+
+    <p>
+    <center>
+      <table border align=center cellpadding=4 width="80%">
+	<caption align=top>
+	  <b>Modification Time Message</b>
+	</caption>
+
+	<tr align=center>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	  <th width="25%">byte</th>
+	</tr>
+
+	<tr align=center>
+	  <td colspan=4>Year</td>
+	</tr>
+
+	<tr align=center>
+	  <td colspan=2>Month</td>
+	  <td colspan=2>Day of Month</td>
+	</tr>
+
+	<tr align=center>
+	  <td colspan=2>Hour</td>
+	  <td colspan=2>Minute</td>
+	</tr>
+
+	<tr align=center>
+	  <td colspan=2>Second</td>
+	  <td colspan=2>Reserved</td>
+	</tr>
+      </table>
+    </center>
+
+    <p>
+    <center>
+      <table align=center width="80%">
+	<tr>
+	  <th width="30%">Field Name</th>
+	  <th width="70%">Description</th>
+	</tr>
+
+	<tr valign=top>
+	  <td>Year</td>
+	  <td>The four-digit year as an ASCII string. For example,
+	    "1998".  All fields of this message should be interpreted
+	    as coordinated universal time (UTC)</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Month</td>
+	  <td>The month number as a two digit ASCII string where
+	    January is "01" and December is "12".</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Day of Month</td>
+	  <td>The day number within the month as a two digit ASCII
+	    string. The first day of the month is "01".</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Hour</td>
+	  <td>The hour of the day as a two digit ASCII string where
+	    midnight is "00" and 11:00pm is "23".</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Minute</td>
+	  <td>The minute of the hour as a two digit ASCII string where
+	    the first minute of the hour is "00" and the last is
+	    "59".</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Second</td>
+	  <td>The second of the minute as a two digit ASCII string
+	    where the first second of the minute is "00" and the last
+	    is "59".</td>
+	</tr>
+
+	<tr valign=top>
+	  <td>Reserved</td>
+	  <td>This field is reserved and should always be zero.</td>
+	</tr>
+      </table>
+    </center>
     
     <hr>
     <h3><a name="SharedMessage">Name: Shared Object Message</a></h3>
@@ -3140,7 +3255,7 @@ data-type.
 <address><a href="mailto:koziol@ncsa.uiuc.edu">Quincey Koziol</a></address>
 <address><a href="mailto:matzke@llnl.gov">Robb Matzke</a></address>
 <!-- hhmts start -->
-Last modified: Mon Jul 20 13:49:08 EDT 1998
+Last modified: Fri Jul 24 15:10:57 EDT 1998
 <!-- hhmts end -->
 </body>
 </html>