From 13b94ce1e2b4c752acf8f726c97f7aac20e96c15 Mon Sep 17 00:00:00 2001
From: Quincey Koziol <koziol@hdfgroup.org>
Date: Thu, 13 May 2004 22:19:53 -0500
Subject: [svn-r8524] Purpose:     Update data storage layout message
 information to reflect changes for "lazy" allocation of dataset's storage and
 compact data storage.

---
 doc/html/H5.format.html | 43 +++++++++++++++++++++++++++++++++++++------
 1 file changed, 37 insertions(+), 6 deletions(-)

diff --git a/doc/html/H5.format.html b/doc/html/H5.format.html
index e983e0a..fbe22e8 100644
--- a/doc/html/H5.format.html
+++ b/doc/html/H5.format.html
@@ -4679,7 +4679,7 @@ TABLE.list TD { border:none; }
 
     <p><b>Purpose and Description:</b> Data layout describes how the
       elements of a multi-dimensional array are arranged in the linear
-      address space of the file. Two types of data layout are
+      address space of the file. Three types of data layout are
       supported:
 
     <ol>
@@ -4699,6 +4699,9 @@ TABLE.list TD { border:none; }
 	the size of the entire array; the size of the entire array can
 	be calculated by traversing the B-tree that stores the chunk
 	addresses.
+
+      <li>The array can be stored in one contiguous block, as part of
+        this object header message.
     </ol>
 
     <p>
@@ -4741,6 +4744,18 @@ TABLE.list TD { border:none; }
 	<tr align=center>
 	  <td colspan=4>...</td>
 	</tr>
+
+	<tr align=center>
+	  <td colspan=4>Compact Data Size (4-bytes)</td>
+	</tr>
+	
+	<tr align=center>
+	  <td colspan=4>Compact Data</td>
+	</tr>
+	
+	<tr align=center>
+	  <td colspan=4>...</td>
+	</tr>
       </table>
     </center>
 
@@ -4754,8 +4769,8 @@ TABLE.list TD { border:none; }
 
 	<tr valign=top>
 	  <td>Version</td>
-	  <td>A version number for the layout message. This
-	    documentation describes version one.</td>
+	  <td>A version number for the layout message. This value can be
+            either 1 or 2.</td>
 	</tr>
 
 	<tr valign=top>
@@ -4769,8 +4784,10 @@ TABLE.list TD { border:none; }
 	  <td>Layout Class</td>
 	  <td>The layout class specifies how the other fields of the
 	    layout message are to be interpreted.  A value of one
-	    indicates contiguous storage while a value of two
-	    indicates chunked storage.  Other values will be defined
+	    indicates contiguous storage, a value of two
+	    indicates chunked storage,
+	    while a value of three
+	    indicates compact storage.  Other values will be defined
 	    in the future.</td>
 	</tr>
 
@@ -4779,7 +4796,10 @@ TABLE.list TD { border:none; }
 	  <td>For contiguous storage, this is the address of the first
 	    byte of storage.  For chunked storage this is the address
 	    of the B-tree that is used to look up the addresses of the
-	    chunks.</td>
+	    chunks.  This field is not present for compact storage.
+            If the version for this message is set to 2, the address
+            may have the "undefined address" value, to indicate that
+            storage has not yet been allocated for this array.</td>
 	</tr>
 
 	<tr valign=top>
@@ -4788,6 +4808,17 @@ TABLE.list TD { border:none; }
 	    size of the array while for chunked storage they define
 	    the size of a single chunk.</td>
 	</tr>
+
+	<tr valign=top>
+	  <td>Compact Data Size</td>
+	  <td>This field is only present for compact data storage.
+            It contains the size of the raw data for the dataset array.</td>
+
+	<tr valign=top>
+	  <td>Compact Data</td>
+	  <td>This field is only present for compact data storage.
+            It contains the raw data for the dataset array.</td>
+	</tr>
       </table>
     </center>
 
-- 
cgit v0.12