Tweak minimized datset header release info.

1 files changed, 20 insertions, 6 deletions

diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index 8ed0a27..8f24b8c 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -146,14 +146,28 @@ New Features
 
     - Add ability to minimze dataset object headers.
 
+      Creation of many, very small datasets resulted in extensive file bloat
+      due to extra space in the dataset object headers -- this space is
+      allocated by default to allow for the insertion of a small number of
+      attributes within the object header and not require a continuation
+      block, an unnecessary provision in the target use case.
+
       Inform the library to expect no attributes on created datasets, and to
       allocate the least space possible for the object headers.
-      A continuation block is created if attributes are added to a 'minimized'
-      dataset, which can reduce performance.
-
-      H5Pget/set_dset_no_attrs_hint, H5Fget/set_no_dset_attrs_hint
-
-      (TRILAB-45)
+      NOTE: A continuation block is created if attributes are added to a
+      'minimized' dataset, which can reduce performance.
+      NOTE: Some extra space is allocated for attributes essential to the
+      correct behavior of the object header (store creation times, e.g.). This
+      does not violate the design principle, as the space is calculated and
+      allocated as needed at the time of dataset object header creation --
+      unused space is not generated.
+      New API calls:
+      H5Fget_dset_no_attrs_hint
+      H5Fset_dset_no_attrs_hint
+      H5Pget_dset_no_attrs_hint
+      H5Pset_dset_no_attrs_hint
+
+      (JOS - 2019/01/04, TRILAB-45)
 
 
      Parallel Library: