[svn-r7552] Purpose:

    Bug/feature fix.

Description:
    Relax restriction on parallel writing to compact datasets to allow partial
I/O.

    Updated reference manual mentioning the issues involved.

Platforms tested:
    FreeBSD 4.9 (sleipnir)
    too minor to require h5committest

2 files changed, 16 insertions, 0 deletions

diff --git a/doc/html/RM_H5D.html b/doc/html/RM_H5D.html
index 0d30cc7..17505db 100644
--- a/doc/html/RM_H5D.html
+++ b/doc/html/RM_H5D.html
@@ -1197,6 +1197,12 @@ facilitate moving easily between them.</i>
 	<a href="RM_H5P.html#Property-SetFillTime">H5Pset_fill_time</a>
 	and 
 	<a href="RM_H5P.html#Property-SetAllocTime">H5Pset_alloc_time</a>.)
+        <p>
+        If a dataset's storage layout is 'compact', care must be taken when
+        writing data to the dataset in parallel.  A compact dataset's raw data
+        is cached in memory and may be flushed to the file from any of the
+        parallel processes, so parallel applications should always attempt to
+        write identical data to the dataset from all processes.
 	
 <dt><strong>Parameters:</strong>
     <dl>
diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html
index e7e377b..cc3cdcb 100644
--- a/doc/html/RM_H5P.html
+++ b/doc/html/RM_H5P.html
@@ -2889,6 +2889,11 @@ facilitate moving easily between them.</i>
     <dd><code>H5Pget_layout</code> returns the layout of the raw data for 
         a dataset.  This function is only valid for dataset creation 
         property lists.  
+        <p>
+        Note that a compact storage layout may affect writing data to
+        the dataset with parallel applications.  See note in
+	<a href="RM_H5D.html#Dataset-Write">H5Dwrite</a>
+        documentation for details.
 	
   <dt><strong>Parameters:</strong>
     <dl>
@@ -6651,6 +6656,11 @@ fid=H5Fcreate("PointA",H5F_ACC_TRUNC,H5P_DEFAULT,fapl);
                     <dd>Store raw data separately from the object header as 
                         chunks of data in separate locations in the file.
             </dl></ul>
+        <p>
+        Note that a compact storage layout may affect writing data to
+        the dataset with parallel applications.  See note in
+	<a href="RM_H5D.html#Dataset-Write">H5Dwrite</a>
+        documentation for details.
   <dt><strong>Parameters:</strong>
     <dl>
         <dt><em>hid_t</em> <code>plist</code>