develop Merge doxygen from 1.12 branch (#2095)

2 files changed, 252 insertions, 320 deletions

diff --git a/doxygen/dox/high_level/extension.dox b/doxygen/dox/high_level/extension.dox
index c81ac6e..d754b96 100644
--- a/doxygen/dox/high_level/extension.dox
+++ b/doxygen/dox/high_level/extension.dox
@@ -1,60 +1,51 @@
 /** \defgroup H5LR Extensions
  *
- * <em>Working with region references, hyperslab selections, 
+ * <em>Working with region references, hyperslab selections,
  * and bit-fields (H5LR, H5LT)</em>
  *
- * The following reference manual entries describe high-level HDF5 C and Fortran APIs 
- * for working with region references, hyperslab selections, and bit-fields. 
- * These functions were created as part of a project supporting 
+ * The following reference manual entries describe high-level HDF5 C and Fortran APIs
+ * for working with region references, hyperslab selections, and bit-fields.
+ * These functions were created as part of a project supporting
  * NPP/NPOESS Data Production and Exploitation (
  * <a href="https://support.hdfgroup.org/projects/jpss/documentation">
- * project </a>, 
- * <a href="https://gamma.hdfgroup.org/ftp/pub/outgoing/NPOESS/source">
- * software </a>). 
- * While they were written to facilitate access to NPP, NPOESS, and JPSS 
- * data in the HDF5 format, these functions may be useful to anyone working 
+ * project</a>, <a href="https://gamma.hdfgroup.org/ftp/pub/outgoing/NPOESS/source">
+ * software </a>).
+ * While they were written to facilitate access to NPP, NPOESS, and JPSS
+ * data in the HDF5 format, these functions may be useful to anyone working
  * with region references, hyperslab selections, or bit-fields.
  *
  * Note that these functions are not part of the standard HDF5 distribution; 
- * the 
- * <a href="https://gamma.hdfgroup.org/ftp/pub/outgoing/NPOESS/source">
- * software </a> 
+ * the <a href="https://gamma.hdfgroup.org/ftp/pub/outgoing/NPOESS/source">
+ * software </a>
  * must be separately downloaded and installed.
  *
- * A comprehensive guide to this library, 
- * <a href="https://support.hdfgroup.org/projects/jpss/documentation/HL/UG/NPOESS_HL-UG.pdf"> 
+ * A comprehensive guide to this library,
+ * <a href="https://support.hdfgroup.org/projects/jpss/documentation/HL/UG/NPOESS_HL-UG.pdf">
  * <em>User Guide to the HDF5 High-level Library for Handling Region References and Hyperslab Selections</em></a>
- * is available at 
+ * is available at
  * https://support.hdfgroup.org/projects/jpss/documentation/HL/UG/NPOESS_HL-UG.pdf.
  *
  * - \ref H5LRcopy_reference
- *        \n Copies data from the specified dataset to a new location and 
- *        creates a reference to it.
+ *        \n Copies data from the specified dataset to a new location and creates a reference to it.
  * - \ref H5LRcopy_region
- *        \n  Copies data from a referenced region to a region in a 
- *        destination dataset.
+ *        \n  Copies data from a referenced region to a region in a destination dataset.
  * - \ref H5LRcreate_ref_to_all
- *        \n  Creates a dataset with the region references to the data in all 
- *        datasets located under a specified group in a file or creates a 
- *        dataset with object references to all objects (groups or datasets) 
+ *        \n  Creates a dataset with the region references to the data in all datasets located under a
+ *        specified group in a file or creates a dataset with object references to all objects (groups or datasets)
  *        located under a specified group in a file.
  * - \ref H5LRcreate_region_references
- *        \n Creates an array of region references using an array of paths to 
+ *        \n Creates an array of region references using an array of paths to
  *        datasets and an array of corresponding hyperslab descriptions.
  * - \ref H5LRget_region_info
  *        \n Retrieves information about the data a region reference points to.
  * - \ref H5LRmake_dataset
- *        \n Creates and writes a dataset containing a list of 
- *        region references.
+ *        \n Creates and writes a dataset containing a list of region references.
  * - \ref H5LRread_region
- *        \n  Retrieves raw data pointed to by a region reference to 
- *        an application buffer.
+ *        \n  Retrieves raw data pointed to by a region reference to an application buffer.
  * - \ref H5LTcopy_region
- *        \n Copies data from a specified region in a source dataset 
- *        to a specified region in a destination dataset.
+ *        \n Copies data from a specified region in a source dataset to a specified region in a destination dataset.
  * - \ref H5LTread_bitfield_value
- *        \n Retrieves the values of quality flags for each element 
- *        to the application provided buffer.
+ *        \n Retrieves the values of quality flags for each element to the application provided buffer.
  * - \ref H5LTread_region
  *        \n Reads selected data to an application buffer.
  *
@@ -77,24 +68,24 @@
  * \param[in] path          Path to the dataset being created
  * \param[in] type_id       Datatype of the dataset
  * \param[in] buf_size      Size of the \p loc_id_ref and \p buf arrays
- * \param[in] loc_id_ref    Array of object identifiers; each identifier 
- *                          describes to which HDF5 file the corresponding 
+ * \param[in] loc_id_ref    Array of object identifiers; each identifier
+ *                          describes to which HDF5 file the corresponding
  *                          region reference belongs to
  * \param[in] buf           Array of region references
  *
  * \return \herr_t
  *
- * \details Given an array of size \p buf_size of region references \p buf, 
- *          the function will create a dataset with path \p path, at location 
- *          specified by \p loc_id and of a datatype specified by \p type_id, 
- *          and will write data associated with each region reference in the order 
- *          corresponding to the order of the region references in the buffer. 
- *          It is assumed that all referenced hyperslabs have the same dimensionality, 
- *          and only the size of the slowest changing dimension may differ. 
- *          Each reference in the \p buf array belongs to the file identified 
+ * \details Given an array of size \p buf_size of region references \p buf,
+ *          the function will create a dataset with path \p path, at location
+ *          specified by \p loc_id and of a datatype specified by \p type_id,
+ *          and will write data associated with each region reference in the order
+ *          corresponding to the order of the region references in the buffer.
+ *          It is assumed that all referenced hyperslabs have the same dimensionality,
+ *          and only the size of the slowest changing dimension may differ.
+ *          Each reference in the \p buf array belongs to the file identified
  *          by the corresponding object identifiers in the array \p loc_id_ref.
  *
- *          If \p path does not exist in \p loc_id then the function will 
+ *          If \p path does not exist in \p loc_id then the function will
  *          create the path specified by \p path automatically.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -103,10 +94,10 @@
  *
  */
 H5_HLRDLL herr_t H5LRmake_dataset(hid_t loc_id,
-				 const char *path, 
-				 hid_t type_id, const size_t buf_size,
-				 const hid_t *loc_id_ref,
-				 const hdset_reg_ref_t *buf);
+                 const char *path,
+                 hid_t type_id, const size_t buf_size,
+                 const hid_t *loc_id_ref,
+                 const hdset_reg_ref_t *buf);
 
 /*-------------------------------------------------------------------------
  *
@@ -119,49 +110,46 @@ H5_HLRDLL herr_t H5LRmake_dataset(hid_t loc_id,
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Creates an array of region references using an array of paths to 
+ * \brief Creates an array of region references using an array of paths to
  *        datasets and an array of corresponding hyperslab descriptions.
  *
  * \param[in] obj_id        File identifier for the HDF5 file containing
  *                          the referenced regions or an object identifier
  *                          for any object in that file
- * \param[in] num_elem      Number of elements in the \p path and 
- *                          \p buf arrays
- * \param[in] path          Array of pointers to strings, which contain 
- *                          the paths to the target datasets for the 
- *                          region references
+ * \param[in] num_elem      Number of elements in the \p path and \p buf arrays
+ * \param[in] path          Array of pointers to strings, which contain
+ *                          the paths to the target datasets for the region references
  * \param[in] block_coord   Array of hyperslab coordinate
- * \param[out] buf          Buffer for returning an array of region 
- *                          references
+ * \param[out] buf          Buffer for returning an array of region references
  *
  * \return \herr_t
  *
  * \note    **Motivation:**
- * \note    H5LRcreate_region_references() is useful when creating 
+ * \note    H5LRcreate_region_references() is useful when creating
  *          large numbers of similar region references.
  *
- * \details H5LRcreate_region_references() creates a list of region references 
- *          given an array of paths to datasets and another array listing the 
+ * \details H5LRcreate_region_references() creates a list of region references
+ *          given an array of paths to datasets and another array listing the
  *          corner coordinates of the corresponding hyperslabs.
  *
  *          \p path parameter is an array of pointers to strings.
  *
- *          \p num_elem specifies the number of region references to be created, 
+ *          \p num_elem specifies the number of region references to be created,
  *          thus specifying the size of the \p path and \p _buf arrays.
  *
- *          Buffer \p block_coord has size 2*rank and is the coordinates of the 
- *          starting point following by the coordinates of the ending point of 
- *          the hyperslab, repeated \p num_elem times for each hyperslab. 
- *          For example, creating two region references to two hyperslabs, 
- *          one with a rectangular hyperslab region starting at element (2,2) 
- *          to element (5,4) and the second rectangular region starting at 
- *          element (7,7) to element (9,10), results in \p block_coord 
+ *          Buffer \p block_coord has size 2*rank and is the coordinates of the
+ *          starting point following by the coordinates of the ending point of
+ *          the hyperslab, repeated \p num_elem times for each hyperslab.
+ *          For example, creating two region references to two hyperslabs,
+ *          one with a rectangular hyperslab region starting at element (2,2)
+ *          to element (5,4) and the second rectangular region starting at
+ *          element (7,7) to element (9,10), results in \p block_coord
  *          being {2,2,5,4, 7,7,9,10}.
  *
- *          The rank of the hyperslab will be the same as the rank of the 
- *          target dataset. H5LRcreate_region_references() will retrieve 
- *          the rank for each dataset and will use those values to interpret 
- *          the values in the buffer. Please note that rank may vary from one 
+ *          The rank of the hyperslab will be the same as the rank of the
+ *          target dataset. H5LRcreate_region_references() will retrieve
+ *          the rank for each dataset and will use those values to interpret
+ *          the values in the buffer. Please note that rank may vary from one
  *          dataset to another.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -170,43 +158,39 @@ H5_HLRDLL herr_t H5LRmake_dataset(hid_t loc_id,
  *
  */
 H5_HLRDLL herr_t H5LRcreate_region_references(hid_t obj_id,
-					     size_t num_elem,
-					     const char **path,
-					     const hsize_t *block_coord,
-					     hdset_reg_ref_t *buf);
+                      size_t num_elem,
+                      const char **path,
+                      const hsize_t *block_coord,
+                      hdset_reg_ref_t *buf);
 
 /**
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Copies data from the specified dataset to a new location and 
- *        creates a reference to it.
+ * \brief Copies data from the specified dataset to a new location and creates a reference to it.
  *
- * \param[in] obj_id        Identifier of any object in a file an 
- *                          HDF5 reference belongs to
+ * \param[in] obj_id        Identifier of any object in a file an HDF5 reference belongs to
  * \param[in] ref           Reference to the datasets region
- * \param[in] file          Name of the destination file 
+ * \param[in] file          Name of the destination file
  * \param[in] path          Full path to the destination dataset
- * \param[in] block_coord   Hyperslab coordinates in the destination 
- *                          dataset
- * \param[out] ref_new      Region reference to the new location of 
- *                          data
+ * \param[in] block_coord   Hyperslab coordinates in the destination dataset
+ * \param[out] ref_new      Region reference to the new location of data
  *
  * \return \herr_t
  *
- * \details Given a data set pointed to by a region reference, the function 
- *          H5LRcopy_reference() will copy the hyperslab data referenced by 
- *          a datasets region reference into existing dataset specified by 
- *          its path \p path in the file with the name \p file, and to location 
- *          specified by the hyperslab coordinates \p block_coord. It will 
- *          create the region reference \p ref_new to point to the new location. 
- *          The number of elements in the old and newly specified regions has 
+ * \details Given a data set pointed to by a region reference, the function
+ *          H5LRcopy_reference() will copy the hyperslab data referenced by
+ *          a datasets region reference into existing dataset specified by
+ *          its path \p path in the file with the name \p file, and to location
+ *          specified by the hyperslab coordinates \p block_coord. It will
+ *          create the region reference \p ref_new to point to the new location.
+ *          The number of elements in the old and newly specified regions has
  *          to be the same.
  *
- *          Buffer \p block_coord has size 2*rank and is the coordinates of 
- *          the starting point following by the coordinates of the ending 
- *          point of the hyperslab. For example, to extract a rectangular 
- *          hyperslab region starting at element (2,2) to element (5,4) 
+ *          Buffer \p block_coord has size 2*rank and is the coordinates of
+ *          the starting point following by the coordinates of the ending
+ *          point of the hyperslab. For example, to extract a rectangular
+ *          hyperslab region starting at element (2,2) to element (5,4)
  *          then \p block_coord would be {2, 2, 5, 4}.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -215,41 +199,39 @@ H5_HLRDLL herr_t H5LRcreate_region_references(hid_t obj_id,
  *
  */
 H5_HLRDLL herr_t H5LRcopy_reference(hid_t obj_id, hdset_reg_ref_t *ref, const char *file,
-				    const char *path, const hsize_t *block_coord, 
-				    hdset_reg_ref_t *ref_new);
+                     const char *path, const hsize_t *block_coord,
+                     hdset_reg_ref_t *ref_new);
 
 /**
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Copies data from a referenced region to a region in a 
- *        destination dataset.
+ * \brief Copies data from a referenced region to a region in a destination dataset.
  *
- * \param[in] obj_id        Identifier of any object in a file 
+ * \param[in] obj_id        Identifier of any object in a file
  *                          dataset region reference belongs to
  * \param[in] ref           Dataset region reference
- * \param[in] file          Name of the destination file 
+ * \param[in] file          Name of the destination file
  * \param[in] path          Full path to the destination dataset
- * \param[in] block_coord   Hyperslab coordinates in the destination 
- *                          dataset
+ * \param[in] block_coord   Hyperslab coordinates in the destination dataset
  *
  * \return \herr_t
  *
- * \details Given a dataset region reference \p ref in a source file 
- *          specified by an identifier of any object in that file 
- *          \p obj_id, the function will write data to the existing 
- *          dataset \p path in file \p file to the simple hyperslab 
+ * \details Given a dataset region reference \p ref in a source file
+ *          specified by an identifier of any object in that file
+ *          \p obj_id, the function will write data to the existing
+ *          dataset \p path in file \p file to the simple hyperslab
  *          specified by \p block_coord.
  *
- *          Buffer \p block_coord has size 2*rank and is the coordinates 
- *          of the starting point following by the coordinates of the 
- *          ending point of the hyperslab. For example, to specify a 
- *          rectangular hyperslab destination region starting at element 
+ *          Buffer \p block_coord has size 2*rank and is the coordinates
+ *          of the starting point following by the coordinates of the
+ *          ending point of the hyperslab. For example, to specify a
+ *          rectangular hyperslab destination region starting at element
  *          (2,2) to element (5,4) then \p block_coord would be {2, 2, 5, 4}.
  *
- *          If \p path does not exist in the destination file (as may be 
- *          the case when writing to a new file) then the dataset will be 
- *          copied directly to the \p path and \p block_coord will be 
+ *          If \p path does not exist in the destination file (as may be
+ *          the case when writing to a new file) then the dataset will be
+ *          copied directly to the \p path and \p block_coord will be
  *          disregarded.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -258,71 +240,66 @@ H5_HLRDLL herr_t H5LRcopy_reference(hid_t obj_id, hdset_reg_ref_t *ref, const ch
  *
  */
 H5_HLRDLL herr_t H5LRcopy_region(hid_t obj_id,
-				hdset_reg_ref_t *ref,
-				const char *file,
-				const char *path,
-				const hsize_t *block_coord);
+                 hdset_reg_ref_t *ref,
+                 const char *file,
+                 const char *path,
+                 const hsize_t *block_coord);
 
 /**
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Creates a dataset with the region references to the data 
- *        in all datasets located under a specified group in a file 
- *        or creates a dataset with object references to all objects 
+ * \brief Creates a dataset with the region references to the data
+ *        in all datasets located under a specified group in a file
+ *        or creates a dataset with object references to all objects
  *        (groups or datasets) located under a specified group in a file.
  *
  * \fg_loc_id
- * \param[in] group_path    Absolute or relative path to the group 
- *                          at which traversal starts
- * \param[in] ds_path       Absolute or relative path to the dataset 
- *                          with region references to be created
- * \param[in] index_type    Index_type; 
- *                          see valid values below in description
- * \param[in] order         Order in which index is traversed; 
- *                          see valid values below in description
- * \param[in] ref_type      Reference type;
- *                          see valid values below in description
+ * \param[in] group_path    Absolute or relative path to the group at which traversal starts
+ * \param[in] ds_path       Absolute or relative path to the dataset with region references to be created
+ * \param[in] index_type    Index_type; see valid values below in description
+ * \param[in] order         Order in which index is traversed; see valid values below in description
+ * \param[in] ref_type      Reference type; see valid values below in description
  *
  * \return \herr_t
  *
- * \details H5LRcreate_ref_to_all() creates a dataset with the 
- *          region references to the data in all datasets located 
- *          under a specified group in a file or creates a dataset with 
- *          object references to all objects (groups or datasets) located 
+ * \details H5LRcreate_ref_to_all() creates a dataset with the
+ *          region references to the data in all datasets located
+ *          under a specified group in a file or creates a dataset with
+ *          object references to all objects (groups or datasets) located
  *          under a specified group in a file.
  *
- *          Given a dataset path \p ds_path in a file specified by the 
- *          \p loc_id identifier, the function H5LRcreate_ref_to_all() 
- *          will create a contiguous one-dimensional dataset with the 
- *          region references or object references depending on the value 
- *          of the \p ref_type parameter. When \p ref_type is 
- *          #H5R_DATASET_REGION, each region reference points to all data 
- *          in a dataset encountered by an internally called H5Lvisit() 
- *          routine, which starts at the group specified by the \p loc_id 
+ *          Given a dataset path \p ds_path in a file specified by the
+ *          \p loc_id identifier, the function H5LRcreate_ref_to_all()
+ *          will create a contiguous one-dimensional dataset with the
+ *          region references or object references depending on the value
+ *          of the \p ref_type parameter. When \p ref_type is
+ *          #H5R_DATASET_REGION, each region reference points to all data
+ *          in a dataset encountered by an internally called H5Lvisit()
+ *          routine, which starts at the group specified by the \p loc_id
  *          and \p group_path parameters. In a like manner, when
- *          \p ref_type is #H5R_OBJECT, each object reference points to 
+ *          \p ref_type is #H5R_OBJECT, each object reference points to
  *          an object (a group or a dataset) encountered by H5Lvisit().
  *
- *          If \p ds_path does not exist in \p loc_id then the function 
+ *          If \p ds_path does not exist in \p loc_id then the function
  *          will create the path specified by \p ds_path automatically.
  *
- *          \p index_type specifies the index to be used. 
+ *          \p index_type specifies the index to be used.
  *          Valid values include the following:
  *          - #H5_INDEX_NAME        Alphanumeric index on name
  *          - #H5_INDEX_CRT_ORDER   Index on creation order
  *
- *          \p order specifies the order in which objects are to be 
- *          inspected along the index specified in \p index_type. 
+ *          \p order specifies the order in which objects are to be
+ *          inspected along the index specified in \p index_type.
  *          Valid values include the following:
  *          - #H5_ITER_INC      Increasing order
  *          - #H5_ITER_DEC      Decreasing order
  *          - #H5_ITER_NATIVE   Fastest available order
  *
- *          For more detailed information on these two parameters, 
- *          see H5Lvisit().
+ *          For more detailed information on these two parameters,
+ *          @see H5Lvisit().
  *
- *          \p ref_type specifies the type of the reference to be used. 
+ *          \p ref_type specifies the type of the reference to be used.
  *          Valid values include the following:
  *          - #H5R_DATASET_REGION   Dataset region reference
  *          - #H5R_OBJECT           Object reference
@@ -333,7 +310,7 @@ H5_HLRDLL herr_t H5LRcopy_region(hid_t obj_id,
  *
  */
 H5_HLRDLL herr_t H5LRcreate_ref_to_all(hid_t loc_id, const char *group_path,
-					 const char *ds_path, H5_index_t index_type, H5_iter_order_t order, H5R_type_t ref_type);
+                  const char *ds_path, H5_index_t index_type, H5_iter_order_t order, H5R_type_t ref_type);
 
 /*-------------------------------------------------------------------------
  *
@@ -352,30 +329,27 @@ H5_HLRDLL herr_t H5LRcreate_ref_to_all(hid_t loc_id, const char *group_path,
  * \param[in] obj_id        File identifier for the HDF5 file containing
  *                          the dataset with the referenced region or an
  *                          object identifier for any object in that file
- * \param[in] ref           Region reference specifying data to be read
- *                          in
- * \param[in] mem_type      Memory datatype of data read from referenced 
+ * \param[in] ref           Region reference specifying data to be read in
+ * \param[in] mem_type      Memory datatype of data read from referenced
  *                          region into the application buffer
- * \param[in,out] numelem   Number of elements to be read into buffer 
- *                          \p buf
- * \param[out] buf          Buffer in which data is returned to the 
- *                          application
+ * \param[in,out] numelem   Number of elements to be read into buffer \p buf
+ * \param[out] buf          Buffer in which data is returned to the application
  *
  * \return \herr_t
  *
- * \details H5LRread_region() reads data pointed to by the region 
+ * \details H5LRread_region() reads data pointed to by the region
  *          reference \p ref into the buffer \p buf.
  *
- *          \p numelem specifies the number of elements to be read 
- *          into \p buf. When the size of the reference region is unknown, 
- *          H5LRread_region() can be called with \p buf set to NULL; 
- *          the number of elements in the referenced region will be returned 
+ *          \p numelem specifies the number of elements to be read
+ *          into \p buf. When the size of the reference region is unknown,
+ *          H5LRread_region() can be called with \p buf set to NULL;
+ *          the number of elements in the referenced region will be returned
  *          in \p numelem.
  *
- *          The buffer buf must be big enough to hold \p numelem elements 
- *          of type \p mem_type. For example, if data is read from the referenced 
- *          region into an integer buffer, \p mem_type should be #H5T_NATIVE_INT 
- *          and the buffer must be at least \c sizeof(int) * \p numelem  bytes 
+ *          The buffer buf must be big enough to hold \p numelem elements
+ *          of type \p mem_type. For example, if data is read from the referenced
+ *          region into an integer buffer, \p mem_type should be #H5T_NATIVE_INT
+ *          and the buffer must be at least \c sizeof(int) * \p numelem  bytes
  *          in size. This buffer must be allocated by the application.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -384,10 +358,10 @@ H5_HLRDLL herr_t H5LRcreate_ref_to_all(hid_t loc_id, const char *group_path,
  *
  */
 H5_HLRDLL herr_t H5LRread_region(hid_t obj_id,
-				const hdset_reg_ref_t *ref, 
-				hid_t mem_type,
-				size_t *numelem,
-				void *buf );
+                 const hdset_reg_ref_t *ref,
+                 hid_t mem_type,
+                 size_t *numelem,
+                 void *buf );
 
 /*-------------------------------------------------------------------------
  *
@@ -400,40 +374,33 @@ H5_HLRDLL herr_t H5LRread_region(hid_t obj_id,
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Retrieves information about the data a region reference 
- *        points to.
+ * \brief Retrieves information about the data a region reference points to.
  *
- * \param[in] obj_id        Identifier of any object in an HDF5 file 
- *                          the region reference belongs to.
+ * \param[in] obj_id        Identifier of any object in an HDF5 file the region reference belongs to.
  * \param[in] ref           Region reference to query
- * \param[in,out] len       Size of the buffer to store \p path in. 
- *                          NOTE: if \p *path is not NULL then \p *len 
- *                          must be the appropriate length
+ * \param[in,out] len       Size of the buffer to store \p path in.
+ *                          NOTE: if \p *path is not NULL then \p *len must be the appropriate length
  * \param[out] path         Full path that a region reference points to
  * \param[out] rank         The number of dimensions of the dataset
- *                          dimensions of the dataset pointed by 
- *                          region reference.
- * \param[out] dtype        Datatype of the dataset pointed by the 
- *                          region reference.
+ *                          dimensions of the dataset pointed by region reference.
+ * \param[out] dtype        Datatype of the dataset pointed by the region reference.
  * \param[out] sel_type     Type of the selection (point or hyperslab)
- * \param[in,out] numelem   Number of coordinate blocks or 
- *                          selected elements.
- * \param[out] buf          Buffer containing description of the region 
- *                          pointed by region reference
+ * \param[in,out] numelem   Number of coordinate blocks or selected elements.
+ * \param[out] buf          Buffer containing description of the region pointed by region reference
  *
  * \return \herr_t
  *
- * \details H5LRget_region_info() queries information about the data 
- *          pointed by a region reference \p ref. It returns one of the 
- *          absolute paths to a dataset, length of the path, dataset’s rank 
- *          and datatype, description of the referenced region and type of 
- *          the referenced region. Any output argument can be NULL if that 
+ * \details H5LRget_region_info() queries information about the data
+ *          pointed by a region reference \p ref. It returns one of the
+ *          absolute paths to a dataset, length of the path, dataset’s rank
+ *          and datatype, description of the referenced region and type of
+ *          the referenced region. Any output argument can be NULL if that
  *          argument does not need to be returned.
  *
- *          The parameter \p obj_id is an identifier for any object in the 
- *          HDF5 file containing the referenced object. For example, it can 
- *          be an identifier of a dataset the region reference belongs to 
- *          or an identifier of an HDF5 file the dataset with region references 
+ *          The parameter \p obj_id is an identifier for any object in the
+ *          HDF5 file containing the referenced object. For example, it can
+ *          be an identifier of a dataset the region reference belongs to
+ *          or an identifier of an HDF5 file the dataset with region references
  *          is stored in.
  *
  *          The parameter \p ref is a region reference to query.
@@ -442,36 +409,36 @@ H5_HLRDLL herr_t H5LRread_region(hid_t obj_id,
  *          buffer of size \p len+1 to return an absolute path to a dataset
  *          the region reference points to.
  *
- *          The parameter \p len is a length of absolute path string plus 
- *          the \0 string terminator. If path parameter is NULL, actual 
- *          length of the path (+1 for \0 string terminator) is returned to 
- *          application and can be used to allocate buffer path of an 
+ *          The parameter \p len is a length of absolute path string plus
+ *          the \0 string terminator. If path parameter is NULL, actual
+ *          length of the path (+1 for \0 string terminator) is returned to
+ *          application and can be used to allocate buffer path of an
  *          appropriate length \p len.
  *
  *          The parameter \p sel_type describes the type of the selected
- *          region. Possible values can be #H5S_SEL_POINTS for point 
+ *          region. Possible values can be #H5S_SEL_POINTS for point
  *          selection and #H5S_SEL_HYPERSLABS for hyperslab selection.
  *
- *          The parameter \p numelem describes how many elements will be 
- *          placed in the buffer \p buf. The number should be interpreted 
+ *          The parameter \p numelem describes how many elements will be
+ *          placed in the buffer \p buf. The number should be interpreted
  *          using the value of \p sel_type.
  *
- *          If value of \p sel_type is #H5S_SEL_HYPERSLABS, the parameter 
- *          \p buf contains \p numelem blocks of the coordinates for each 
- *          simple hyperslab of the referenced region. Each block has 
- *          length \c 2*\p rank and is organized as follows: <"start" coordinate>, 
- *          immediately followed by <"opposite" corner coordinate>. 
- *          The total size of the buffer to hold the description of the 
- *          region will be \c 2*\p rank*\p numelem. If region reference 
- *          points to a contiguous sub-array, then the value of \p numelem 
- *          is 1 and the block contains coordinates of the upper left and 
+ *          If value of \p sel_type is #H5S_SEL_HYPERSLABS, the parameter
+ *          \p buf contains \p numelem blocks of the coordinates for each
+ *          simple hyperslab of the referenced region. Each block has
+ *          length \c 2*\p rank and is organized as follows: <"start" coordinate>,
+ *          immediately followed by <"opposite" corner coordinate>.
+ *          The total size of the buffer to hold the description of the
+ *          region will be \c 2*\p rank*\p numelem. If region reference
+ *          points to a contiguous sub-array, then the value of \p numelem
+ *          is 1 and the block contains coordinates of the upper left and
  *          lower right corners of the sub-array (or simple hyperslab).
  *
- *          If value of \p sel_type is #H5S_SEL_POINTS, the parameter \p buf 
- *          contains \p numelem blocks of the coordinates for each selected 
- *          point of the referenced region. Each block has length \p rank 
- *          and contains coordinates of the element. The total size of the 
- *          buffer to hold the description of the region will be 
+ *          If value of \p sel_type is #H5S_SEL_POINTS, the parameter \p buf
+ *          contains \p numelem blocks of the coordinates for each selected
+ *          point of the referenced region. Each block has length \p rank
+ *          and contains coordinates of the element. The total size of the
+ *          buffer to hold the description of the region will be
  *          \p rank* \p numelem.
  *
  *
@@ -481,14 +448,14 @@ H5_HLRDLL herr_t H5LRread_region(hid_t obj_id,
  *
  */
 H5_HLRDLL herr_t H5LRget_region_info(hid_t obj_id,
-				    const hdset_reg_ref_t *ref,  
-				    size_t *len, 
-				    char *path,
-				    int *rank,
-				    hid_t *dtype,
-				    H5S_sel_type *sel_type,
-				    size_t *numelem,
-				    hsize_t *buf );
+                     const hdset_reg_ref_t *ref,
+                     size_t *len, 
+                     char *path,
+                     int *rank,
+                     hid_t *dtype,
+                     H5S_sel_type *sel_type,
+                     size_t *numelem,
+                     hsize_t *buf );
 
 
 
@@ -503,35 +470,33 @@ H5_HLRDLL herr_t H5LRget_region_info(hid_t obj_id,
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Copies data from a specified region in a source dataset 
+ * \brief Copies data from a specified region in a source dataset
  *        to a specified region in a destination dataset
  *
  * \param[in] file_src          Name of the source file
  * \param[in] path_src          Full path to the source dataset
- * \param[in] block_coord_src   Hyperslab coordinates in the 
- *                              source dataset
+ * \param[in] block_coord_src   Hyperslab coordinates in the source dataset
  * \param[in] file_dest         Name of the destination file
  * \param[in] path_dest         Full path to the destination dataset
- * \param[in] block_coord_dset  Hyperslab coordinates in the 
- *                              destination dataset
+ * \param[in] block_coord_dset  Hyperslab coordinates in the destination dataset
  *
  * \return \herr_t
  *
- * \details Given a path to a dataset \p path_src in a file with the 
- *          name \p file_src, and description of a simple hyperslab of 
- *          the source \p block_coord_src, the function will write data 
- *          to the dataset \p path_dest in file \p file_dest to the 
- *          simple hyperslab specified by \p block_coord_dset. 
- *          The arrays \p block_coord_src and \p block_coord_dset have 
- *          a length of 2*rank and are the coordinates of the starting 
- *          point following by the coordinates of the ending point of the 
- *          hyperslab. For example, to specify a rectangular hyperslab 
- *          destination region starting at element (2,2) to element (5,4) 
+ * \details Given a path to a dataset \p path_src in a file with the
+ *          name \p file_src, and description of a simple hyperslab of
+ *          the source \p block_coord_src, the function will write data
+ *          to the dataset \p path_dest in file \p file_dest to the
+ *          simple hyperslab specified by \p block_coord_dset.
+ *          The arrays \p block_coord_src and \p block_coord_dset have
+ *          a length of 2*rank and are the coordinates of the starting
+ *          point following by the coordinates of the ending point of the
+ *          hyperslab. For example, to specify a rectangular hyperslab
+ *          destination region starting at element (2,2) to element (5,4)
  *          then \p block_coord_dset would be {2, 2, 5, 4}.
  *
- *          If \p path_dest does not exist in the destination file 
- *          (as may be the case when writing to a new file) then the 
- *          dataset will be copied directly to the \p path_dest and 
+ *          If \p path_dest does not exist in the destination file
+ *          (as may be the case when writing to a new file) then the
+ *          dataset will be copied directly to the \p path_dest and
  *          \p block_coord_dset will be disregarded.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -540,11 +505,11 @@ H5_HLRDLL herr_t H5LRget_region_info(hid_t obj_id,
  *
  */
 H5_HLRDLL herr_t H5LTcopy_region(const char *file_src,
-				const char *path_src,
-				const hsize_t *block_coord_src,
-				const char *file_dest,
-				const char *path_dest,
-				const hsize_t *block_coord_dset);
+                 const char *path_src,
+                 const hsize_t *block_coord_src,
+                 const char *file_dest,
+                 const char *path_dest,
+                 const hsize_t *block_coord_dset);
 
 /*-------------------------------------------------------------------------
  *
@@ -562,27 +527,25 @@ H5_HLRDLL herr_t H5LTcopy_region(const char *file_src,
  * \param[in] file          Name of file
  * \param[in] path          Full path to a dataset
  * \param[in] block_coord   Hyperslab coordinates
- * \param[in] mem_type      Memory datatype, describing the buffer 
- *                          the referenced data will be read into
- * \param[out] buf          Buffer containing data from the 
- *                          referenced region
+ * \param[in] mem_type      Memory datatype, describing the buffer the referenced data will be read into
+ * \param[out] buf          Buffer containing data from the referenced region
  *
  * \return \herr_t
  *
- * \details H5LTread_region() reads data from a region described by 
- *          the hyperslab coordinates in \p block_coord, located in 
- *          the dataset specified by its absolute path \p path in a 
- *          file specified by its name \p file. Data is read into a 
- *          buffer \p buf of the datatype that corresponds to the 
+ * \details H5LTread_region() reads data from a region described by
+ *          the hyperslab coordinates in \p block_coord, located in
+ *          the dataset specified by its absolute path \p path in a
+ *          file specified by its name \p file. Data is read into a
+ *          buffer \p buf of the datatype that corresponds to the
  *          HDF5 datatype specified by \p mem_type.
  *
- *          Buffer \p block_coord has size 2*rank and is the coordinates 
- *          of the starting point following by the coordinates of the 
- *          ending point of the hyperslab. For example, to extract a 
- *          rectangular hyperslab region starting at element (2,2) to 
+ *          Buffer \p block_coord has size 2*rank and is the coordinates
+ *          of the starting point following by the coordinates of the
+ *          ending point of the hyperslab. For example, to extract a
+ *          rectangular hyperslab region starting at element (2,2) to
  *          element (5,4) then \p block_coord would be {2, 2, 5, 4}.
  *
- *          Buffer \p buf should be big enough to hold selected elements 
+ *          Buffer \p buf should be big enough to hold selected elements
  *          of the type that corresponds to the \p mem_type
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -591,57 +554,55 @@ H5_HLRDLL herr_t H5LTcopy_region(const char *file_src,
  *
  */
 H5_HLRDLL herr_t  H5LTread_region(const char *file,
-				 const char *path,
-				 const hsize_t *block_coord,
-				 hid_t mem_type,
-				 void *buf );
+                  const char *path,
+                  const hsize_t *block_coord,
+                  hid_t mem_type,
+                  void *buf );
 
 /**
  * --------------------------------------------------------------------------
  * \ingroup H5LR
  *
- * \brief Retrieves the values of quality flags for each element 
+ * \brief Retrieves the values of quality flags for each element
  *        to the application provided buffer.
  *
  * \param[in] dset_id   Identifier of the dataset with bit-field values
  * \param[in] num_values    Number of the values to be extracted
- * \param[in] offset        Array of staring bits to be extracted from 
+ * \param[in] offset        Array of staring bits to be extracted from
  *                          the element; valid values: 0 (zero) through 7
- * \param[in] lengths       Array of the number of bits to be extracted 
- *                          for each value
- * \param[in] space         Dataspace identifier, describing the elements 
- *                          to be read from the dataset with bit-field 
- *                          values
+ * \param[in] lengths       Array of the number of bits to be extracted for each value
+ * \param[in] space         Dataspace identifier, describing the elements
+ *                          to be read from the dataset with bit-field values
  * \param[out] buf          Buffer to read the values in
  *
  * \return \herr_t
  *
- * \details H5LTread_bitfield_value() reads selected elements from a 
- *          dataset specified by its identifier \p dset_id, and unpacks 
+ * \details H5LTread_bitfield_value() reads selected elements from a
+ *          dataset specified by its identifier \p dset_id, and unpacks
  *          the bit-field values to a buffer \p buf.
  *
- *          The parameter \p space is a space identifier that indicates 
+ *          The parameter \p space is a space identifier that indicates
  *          which elements of the dataset should be read.
  *
- *          The parameter \p offset is an array of length \p num_values; 
+ *          The parameter \p offset is an array of length \p num_values;
  *          the i<sup>th</sup> element of the array holds the value of the
- *          starting bit of the i<sup>th</sup> bit-field value. 
+ *          starting bit of the i<sup>th</sup> bit-field value.
  *          Valid values are: 0 (zero) through 7.
  *
- *          The parameter \p lengths is an array of length \p num_values; 
- *          the i<sup>th</sup> element of the array holds the number of 
- *          bits to be extracted for the i<sup>th</sup> bit-field value. 
- *          Extracted bits will be interpreted as a base-2 integer value. 
- *          Each value will be converted to the base-10 integer value and 
- *          stored in the application buffer. 
- *
- *          Buffer \p buf is allocated by the application and should be big 
- *          enough to hold \c num_sel_elem * \p num_values elements of the 
- *          specified type, where \c num_sel_elem is a number of the elements 
- *          to be read from the dataset. Data in the buffer is organized 
- *          as \p num_values values for the first element, followed by the 
- *          \p num_values values for the second element, ... , followed by 
- *          the \p num_values values for the 
+ *          The parameter \p lengths is an array of length \p num_values;
+ *          the i<sup>th</sup> element of the array holds the number of
+ *          bits to be extracted for the i<sup>th</sup> bit-field value.
+ *          Extracted bits will be interpreted as a base-2 integer value.
+ *          Each value will be converted to the base-10 integer value and
+ *          stored in the application buffer.
+ *
+ *          Buffer \p buf is allocated by the application and should be big
+ *          enough to hold \c num_sel_elem * \p num_values elements of the
+ *          specified type, where \c num_sel_elem is a number of the elements
+ *          to be read from the dataset. Data in the buffer is organized
+ *          as \p num_values values for the first element, followed by the
+ *          \p num_values values for the second element, ... , followed by
+ *          the \p num_values values for the
  *          \c num_selected_elem<sup>th</sup> element.
  *
  * \version 1.1 Fortran wrapper introduced in this release.
@@ -650,5 +611,5 @@ H5_HLRDLL herr_t  H5LTread_region(const char *file,
  *
  */
 H5_HLRDLL herr_t H5LTread_bitfield_value(hid_t dset_id, int num_values, const unsigned *offset,
-					const unsigned *lengths, hid_t space, int *buf);
+                 const unsigned *lengths, hid_t space, int *buf);
 
diff --git a/doxygen/dox/high_level/high_level.dox b/doxygen/dox/high_level/high_level.dox
deleted file mode 100644
index c53d298..0000000
--- a/doxygen/dox/high_level/high_level.dox
+++ /dev/null
@@ -1,29 +0,0 @@
-/** \page high_level High-level library
- * The high-level HDF5 library includes several sets of convenience and standard-use APIs to 
- * facilitate common HDF5 operations.
- *
- * <ul>
- * <li>\ref H5LT "Lite (H5LT, H5LD)"
- * \n
- * Functions to simplify creating and manipulating datasets, attributes and other features
- * <li>\ref H5IM "Image (H5IM)"
- * \n
- * Creating and manipulating HDF5 datasets intended to be interpreted as images
- * <li>\ref H5TB "Table (H5TB)"
- * \n
- * Creating and manipulating HDF5 datasets intended to be interpreted as tables
- * <li>\ref H5PT "Packet Table (H5PT)"
- * \n
- * Creating and manipulating HDF5 datasets to support append- and read-only operations on table data
- * <li>\ref H5DS "Dimension Scale (H5DS)"
- * \n
- * Creating and manipulating HDF5 datasets that are associated with the dimension of another HDF5 dataset
- * <li>\ref H5DO "Optimizations (H5DO)"
- * \n
- * Bypassing default HDF5 behavior in order to optimize for specific use cases
- * <li>\ref H5LR "Extensions (H5LR, H5LT)"
- * \n
- * Working with region references, hyperslab selections, and bit-fields
- * </ul>
- * 
- */