[svn-r10971] Purpose: Bug fix

Description: See details from Bug #213.  Family member file size wasn't saved
anywhere in file.  When family file is opened, the first member size determine
the member size.

Solution:  Hopefully, this is the last step of checkin for this stage.  This step
mainly enables h5repart tool to be able to convert file driver from family to
sec2.  Because the library saves family information in file, in trying to convert
to sec2 driver, the library simply change the address of driver information to
undefined so that the driver information block can be ignored.  This step also
updates the reference manual of H5Pset_fapl_family() and h5repart.

In the fifth step of checkin, backward compatibility with v1.6
is tested.  A family file created was created with the v1.6 library and opened
with this version of the library.

In the fourth step of checkin, a test suit is added for h5repart,
including a program to generate the test files, a script file to run h5repart,
and a program to verify repartitioned files can be opened by the library.

There's a change from the first step of checkin.  Family name template is no
longer saved in the superblock because different pathname can make the name
different.

In the third step of checkin, h5repart has been modified.  If h5repart is used
to change the size of family member file, the new size(actual member size) is saved
in the superblock.

In the second step of checkin, multi driver is checked against the driver
name saved in superblock.  Wrong driver will result in a failure with an error message
indicating
multi driver should be used.  This change includes split driver because it's a special
case for multi
driver.

In the first step of checkin.  Family member size and name template(unused at this stage) are saved
in file superblock.  When file is reopened,the size passed in thrin superblock.  A different size
will trigger a failure with an error message indicating the right size.  Wrong driver to open family
file will cause a failure, too.


Platforms tested: h5committest and fuss.

Misc. update: doc/html/RM_H5P.html and doc/html/Tools.html

2 files changed, 22 insertions, 7 deletions

diff --git a/doc/html/RM_H5P.html b/doc/html/RM_H5P.html
index 2d0572a..bc6eae6 100644
--- a/doc/html/RM_H5P.html
+++ b/doc/html/RM_H5P.html
@@ -6799,8 +6799,14 @@ END SUBROUTINE h5pset_fapl_core_f
     <dd><code>H5Pset_fapl_family</code> sets the file access property list 
         identifier, <code>fapl_id</code>, to use the family driver.
         <p>
-        <code>memb_size</code> is the size in bytes of each file member 
-        and is used only when creating a new file.
+        <code>memb_size</code> is the size in bytes of each file member.  This size
+        will be saved in the file when the property list <code>fapl_id</code> is used
+        to create a new file.  If <code>fapl_id</code> is used to open an existing
+        file, <code>memb_size</code> has to be equal to the original size saved in 
+        the file.  A failure with an errror message indicating the correct member 
+        size will be returned if <code>memb_size</code> does not match the size saved.
+        If any user does not know the original size, <code>H5F_FAMILY_DEFAULT</code>
+        can be passed in.  The library will retrieve the correct size saved in the file. 
         <p>
         <code>memb_fapl_id</code> is the identifier of the 
         file access property list to be used for each family member. 
diff --git a/doc/html/Tools.html b/doc/html/Tools.html
index 70f7735..afe27dd 100644
--- a/doc/html/Tools.html
+++ b/doc/html/Tools.html
@@ -893,16 +893,22 @@ installed with HDF5.
         [-v] 
         [-V] 
         [-[b|m]</code><em>N</em><code>[g|m|k]]</code>
+        [-family_to_sec2]
         <em>source_file
         dest_file</em>
 <dt><strong>Purpose:</strong>
     <dd>Repartitions a file or family of files.
 <dt><strong>Description:</strong>
-    <dd><code>h5repart</code> splits a single file into a family of 
-        files, joins a family of files into a single file, or copies 
-        one family of files to another while changing the size of the 
-        family members.  <code>h5repart</code> can also be used to 
-        copy a single file to a single file with holes.
+    <dd><code>h5repart</code> joins a family of files into a single file, 
+        or copies one family of files to another while changing the size 
+        of the family members.  <code>h5repart</code> can also be used to 
+        copy a single file to a single file with holes.  At this stage, 
+        <code>h5repart</code> can not split a single non-family file into
+        a family of file(s).
+        <p>
+        To convert a family of file(s) to a single non-family file 
+        (<code>sec2</code> file), the option <code>-family_to_sec2</code> 
+        has to be used.
         <p>
         Sizes associated with the <code>-b</code> and <code>-m</code> 
         options may be suffixed with <code>g</code> for gigabytes, 
@@ -926,6 +932,9 @@ installed with HDF5.
 		    <td valign="top"><code>-m</code><em>N</em></td>
             <td valign="top">The destination member size or 1GB</td></tr>
         <tr>
+		    <td valign="top"><code>-family_to_sec2</code></td>
+            <td valign="top">Convert file driver from family to sec2</td></tr>
+        <tr>
 		    <td valign="top"><em>source_file&nbsp;&nbsp;&nbsp;&nbsp;</em></td>
             <td valign="top">The name of the source file</td></tr>
         <tr>