summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorbmribler <39579120+bmribler@users.noreply.github.com>2023-10-22 00:15:12 (GMT)
committerGitHub <noreply@github.com>2023-10-22 00:15:12 (GMT)
commit21ec3730c5d625995cd406e29ae5cb84dc45a11c (patch)
treea3334b4e887bb22168bc51f1ffa9bf2bbf2b6193 /src
parent4dfde6bac7395386379072c532560fbe8a5b6f79 (diff)
downloadhdf5-21ec3730c5d625995cd406e29ae5cb84dc45a11c.zip
hdf5-21ec3730c5d625995cd406e29ae5cb84dc45a11c.tar.gz
hdf5-21ec3730c5d625995cd406e29ae5cb84dc45a11c.tar.bz2
Additional update to the library version matrix for H5Pset_libver_bounds() (#3742)
This is the follow-up of PR #3702.
Diffstat (limited to 'src')
-rw-r--r--src/H5Ppublic.h232
1 files changed, 87 insertions, 145 deletions
diff --git a/src/H5Ppublic.h b/src/H5Ppublic.h
index d79c7d7..3a05910 100644
--- a/src/H5Ppublic.h
+++ b/src/H5Ppublic.h
@@ -4849,14 +4849,13 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* <td>\p low=#H5F_LIBVER_EARLIEST<br />
* \p high=#H5F_LIBVER_V18</td>
* <td>
- * \li The library will create objects with the earliest
- * possible format versions.
- * \li The library will allow objects to be created with the
- * latest format versions available to library release 1.8.x.
- * \li API calls that create objects or features that are
- * available to versions of the library greater than 1.8.x
- * release will fail.
- * </td>
+ * \li The library will create objects with the earliest
+ * possible format versions.
+ * \li The library will allow objects to be created with the
+ * latest format versions available to library release 1.8.x.
+ * \li API calls that create objects or features that are
+ * available to versions of the library greater than 1.8.x
+ * release will fail.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_EARLIEST<br />
@@ -4865,12 +4864,10 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* \li The library will create objects with the earliest possible
* format versions.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.10.x. Note
- * that as 1.10.11 is the last release of the 1.10 series.
+ * format versions available to library release 1.10.x.
* \li API calls that create objects or features that are
* available to versions of the library greater than 1.10.x
- * release will fail.
- * </td>
+ * release will fail.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_EARLIEST<br />
@@ -4879,12 +4876,10 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* \li The library will create objects with the earliest possible
* format versions.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.12.x. Note
- * that as 1.12.3 is the last release of the 1.12 series.
+ * format versions available to library release 1.12.x.
* \li API calls that create objects or features that are
* available to versions of the library greater than 1.12.x
- * release will fail.
- * </td>
+ * release will fail.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_EARLIEST<br />
@@ -4896,8 +4891,7 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* format versions available to library release 1.14.x.
* \li API calls that create objects or features that are
* available to versions of the library greater than 1.14.x
- * release will fail.
- * </td>
+ * release will fail.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_EARLIEST<br />
@@ -4906,15 +4900,10 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* \li The library will create objects with the earliest possible
* format versions.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
* \li This is the library default setting and provides the greatest
- * format compatibility.
- * </td>
+ * format compatibility.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V18<br />
@@ -4922,6 +4911,11 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.8.x.
+ * \li The library will allow objects to be created with the latest
+ * format versions available to library release 1.8.x.
+ * \li The objects written with this setting may be
+ * accessible to a smaller range of library versions than
+ * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li API calls that create objects or features that are available
* to versions of the library greater than 1.8.x release will
* fail.
@@ -4932,71 +4926,66 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* <td>\p low=#H5F_LIBVER_V18<br />
* \p high=#H5F_LIBVER_V110</td>
* <td>
- * \li The library will create objects with the latest format
- * versions available to library release 1.8.x.
- * \li The library will allow objects to be created with the latest
- * format versions available to library release 1.10.x. Note
- * that 1.10.11 is the last release of the 1.10 series.
- * \li API calls that create objects or features that are
- * available to versions of the library greater than 1.10.x
- * release will fail.
- * \li Earlier versions of the library may not be able to access
- * objects created with this setting.</td>
+ * \li The library will create objects with the latest format
+ * versions available to library release 1.8.x.
+ * \li The library will allow objects to be created with the latest
+ * format versions available to library release 1.10.x.
+ * \li API calls that create objects or features that are
+ * available to versions of the library greater than 1.10.x
+ * release will fail.
+ * \li Earlier versions of the library may not be able to access
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V18<br />
* \p high=#H5F_LIBVER_V112</td>
* <td>
- * \li The library will create objects with the latest format
- * versions available to library release 1.8.x.
- * \li The library will allow objects to be created with the latest
- * format versions available to library release 1.12.x.
- * \li API calls that create objects or features that are
- * available to versions of the library greater than 1.12.x
- * release will fail.
- * \li Earlier versions of the library may not be able to access
- * objects created with this setting.</td>
+ * \li The library will create objects with the latest format
+ * versions available to library release 1.8.x.
+ * \li The library will allow objects to be created with the latest
+ * format versions available to library release 1.12.x.
+ * \li API calls that create objects or features that are
+ * available to versions of the library greater than 1.12.x
+ * release will fail.
+ * \li Earlier versions of the library may not be able to access
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V18<br />
* \p high=#H5F_LIBVER_V114</td>
* <td>
- * \li The library will create objects with the latest format
- * versions available to library release 1.8.x.
- * \li The library will allow objects to be created with the latest
- * format versions available to library release 1.14.x.
- * \li API calls that create objects or features that are
- * available to versions of the library greater than 1.14.x
- * release will fail.
- * \li Earlier versions of the library may not be able to access
- * objects created with this setting.</td>
+ * \li The library will create objects with the latest format
+ * versions available to library release 1.8.x.
+ * \li The library will allow objects to be created with the latest
+ * format versions available to library release 1.14.x.
+ * \li API calls that create objects or features that are
+ * available to versions of the library greater than 1.14.x
+ * release will fail.
+ * \li Earlier versions of the library may not be able to access
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V18<br />
* \p high=#H5F_LIBVER_V116</td>
* <td>
- * \li The library will create objects with the latest format
- * versions available to library release 1.8.x.
- * \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
- * \li Earlier versions of the library may not be able to access
- * objects created with this setting.</td>
+ * \li The library will create objects with the latest format
+ * versions available to library release 1.8.x.
+ * \li The library will allow objects to be created with the latest
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
+ * \li This setting allows users to take advantage of the latest
+ * features and performance enhancements in the library.
+ * \li Earlier versions of the library may not be able to access
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V110<br />
- * \p high=#H5F_LIBVER_V110
- * </td>
+ * \p high=#H5F_LIBVER_V110</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.10.x.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.10.x. Note
- * that 1.10.11 is the last release of the 1.10 series.
+ * format versions available to library release 1.10.x.
* \li The objects written with this setting may be
* accessible to a smaller range of library versions than
* would be the case if low is set to #H5F_LIBVER_EARLIEST.
@@ -5005,72 +4994,52 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V110<br />
- * \p high=#H5F_LIBVER_V112
- * </td>
+ * \p high=#H5F_LIBVER_V112</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.10.x.
* \li The library will allow objects to be created with the latest
* format versions available to library release 1.12.x.
- * \li The objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li API calls that create objects or features that are available
* to versions of the library greater than 1.12.x release will
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V110<br />
- * \p high=#H5F_LIBVER_V114
- * </td>
+ * \p high=#H5F_LIBVER_V114</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.10.x.
* \li The library will allow objects to be created with the latest
* format versions available to library release 1.14.x.
- * \li The objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li API calls that create objects or features that are available
* to versions of the library greater than 1.14.x release will
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V110<br />
- * \p high=#H5F_LIBVER_V116
- * </td>
+ * \p high=#H5F_LIBVER_V116</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.10.x.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
* \li This setting allows users to take advantage of the latest
* features and performance enhancements in the library.
- * However, objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li Earlier versions of the library may not be able to access
- * objects created with this setting.
- * </td>
+ * objects created with this setting.</td>
+ * </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V112<br />
- * \p high=#H5F_LIBVER_V112
- * </td>
+ * \p high=#H5F_LIBVER_V112</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.12.x.
@@ -5084,55 +5053,38 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V112<br />
- * \p high=#H5F_LIBVER_V114
- * </td>
+ * \p high=#H5F_LIBVER_V114</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.12.x.
* \li The library will allow objects to be created with the latest
* format versions available to library release 1.14.x.
- * \li The objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li API calls that create objects or features that are available
* to versions of the library greater than 1.14.x release will
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
- * </tr>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V112<br />
- * \p high=#H5F_LIBVER_V116
- * </td>
+ * \p high=#H5F_LIBVER_V116</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.12.x.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
* \li This setting allows users to take advantage of the latest
* features and performance enhancements in the library.
- * However, objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li Earlier versions of the library may not be able to access
- * objects created with this setting.
- * </td>
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V114<br />
- * \p high=#H5F_LIBVER_V114
- * </td>
+ * \p high=#H5F_LIBVER_V114</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.14.x.
@@ -5146,57 +5098,47 @@ H5_DLL herr_t H5Pset_gc_references(hid_t fapl_id, unsigned gc_ref);
* fail.
* \li Earlier versions of the library may not be able to access
* objects created with this setting.</td>
- * </td>
- * </tr>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V114<br />
- * \p high=#H5F_LIBVER_V116
- * </td>
+ * \p high=#H5F_LIBVER_V116</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.14.x.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
* \li This setting allows users to take advantage of the latest
* features and performance enhancements in the library.
- * However, objects written with this setting may be
- * accessible to a smaller range of library versions than
- * would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li Earlier versions of the library may not be able to access
- * objects created with this setting.
- * </td>
+ * objects created with this setting.</td>
* </tr>
* <tr>
* <td>\p low=#H5F_LIBVER_V116<br />
- * \p high=#H5F_LIBVER_V116
- * </td>
+ * \p high=#H5F_LIBVER_V116</td>
* <td>
* \li The library will create objects with the latest format
* versions available to library release 1.16.x.
* \li The library will allow objects to be created with the latest
- * format versions available to library release 1.16.x.
- * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
- * limit on the format versions to use. That is, if a
- * newer format version is required to support a feature
- * in 1.16.x series, this setting will allow the object to be
- * created.
+ * format versions available to library release 1.16.x. See
+ * note *H5F_LIBVER_LATEST* below the table.
* \li This setting allows users to take advantage of the latest
* features and performance enhancements in the library.
* However, objects written with this setting may be
* accessible to a smaller range of library versions than
* would be the case if low is set to #H5F_LIBVER_EARLIEST.
* \li Earlier versions of the library may not be able to access
- * objects created with this setting.
- * </td>
+ * objects created with this setting.</td>
* </tr>
* </table>
*
+ * \note *H5F_LIBVER_LATEST*:<br />
+ * Since 1.16.x is also #H5F_LIBVER_LATEST, there is no upper
+ * limit on the format versions to use. That is, if a
+ * newer format version is required to support a feature
+ * in 1.16.x series, this setting will allow the object to be
+ * created.
+ *
* \version 1.10.2 #H5F_LIBVER_V18 added to the enumerated defines in
* #H5F_libver_t.
*