Hdf5 1 12 doxygen merge (#615)

* OESS-98 fix tools test for plugins

* sync fork

* Merge of changes from dev

* Move problem option to bottom of the list until fixed

* HDFFV-11106 - fix parsing optional args

* HDFFV-11106 add note

* grammer fix

* Whitespace after clang formatting

* Undo format version 11 changes

* Update check to working version

* Merge workflow and minor changes from develop

* Update supported platforms

* PR#3 merge from develop

* Merge gcc 10 diagnostics option from develop

* Merge #318 OSX changes from develop

* Merge serval small changes from dev

* fix typo

* Minor non-space formatting changes

* GH #386 copyright corrections for java folder

* revert because logic requires false return

* Merges from develop

#358 patches from vtk
#361 fix header guard spelling

* Remove case statement for H5I_EVENTSET

* Correct call with versioning

* Remove tabs

* Double underscore change

* Merges from develop

#340 clang -Wformat-security warnings
#360 Fixed uninitialized warnings
Remove more underscores from header guards

* Merge #380 from develop

* Correct date entry

* Split format source and commit changes on repo push

* remove pre-split setting

* Change windows TS to use older VS.

* HDFFV-11212 JNI export util and Javadoc

* Suggested review changes

* Another change found

* Committing clang-format changes

* Some Javadoc warning fixes

* Committing clang-format changes

* Updated javadoc fixes

* HDFFV-11228/9 merges from develop

* remove obsolete debug comment

* Fix conflict

* HDFFV-11229 merge changes from develop

* HDFFV-11229 merge second compare from develop

* HDFFV-11229 fix reference file

* HDFFV-11229 update autotools test script for two ref files

* HDFFV-11229 merge dev changes for long double display in tools

* Committing clang-format changes

* Update with changes from develop

* Add "option" command for clang options

* Rework CMake add_custom to use the BYPRODUCTS argument

Update pkgconfig scripts for parallel builds.
Fix install COPYING file reference.
Remove unused round defines.
Change CMake default setting of BUILD_CPP to off.

* Whitespace changes

* Rework CMake add_custom to use the BYPRODUCTS argument

* Revert CMake configure checks for round defines

* With VS 2015 minimum strdup is supported

* Doxygen comments merged from develop

* doxygen build updates

* Correct version string for map functions

Co-authored-by: github-actions <41898282+github-actions[bot]@users.noreply.github.com>

1 files changed, 30 insertions, 79 deletions

diff --git a/doxygen/dox/H5Oget_info.dox b/doxygen/dox/H5Oget_info.dox
index e8b7afa..ee4cd1c 100644
--- a/doxygen/dox/H5Oget_info.dox
+++ b/doxygen/dox/H5Oget_info.dox
@@ -1,10 +1,10 @@
 /**
  * \ingroup H5O
- * \def H5Oget_info()
+ * \def H5Oget_info
  *
  * #H5Oget_info is a macro that is mapped to:
- * \li H5Oget_info3()
- * \li H5Oget_info1()
+ * \li #H5Oget_info3
+ * \li #H5Oget_info1
  *
  * \details Such macros are provided to facilitate application
  *          compatibility. Their use and mappings are fully described in
@@ -12,8 +12,8 @@
  *          document closely.
  *
  *          In HDF5 versions 1.12 and after, #H5Oget_info is mapped to
- *          \ref H5Oget_info3() and \ref H5Oget_info1() is deprecated. 
- *          In version 1.10 #H5Oget_info is identical to \ref H5Oget_info1(). 
+ *          #H5Oget_info3 and #H5Oget_info1 is deprecated. 
+ *          In version 1.10 #H5Oget_info is identical to #H5Oget_info1. 
  * 
  *          Specific compile-time compatibility flags and the resulting
  *          mappings are as follows:
@@ -22,100 +22,51 @@
  *  <tr>
  *      <th>Compatibility setting</th>
  *      <th>H5Oget_info</th>
- * </tr>
- *  <tr>
- *      <td>No compatibility flag</td>
- *      <td>\ref H5Oget_info3() (in release 1.12)</td>
  *  </tr>
  *  <tr>
-        <td></td>
- *      <td>\ref H5Oget_info1() (in 1.8 or 1.10)</td>
+ *      <td>No compatibility flag \n &nbsp;</td>
+ *      <td>#H5Oget_info3 (in release 1.12) \n
+ *          #H5Oget_info1 (in 1.8 or 1.10)</td>
  *  </tr>
  *  <tr>
  *      <td>Emulate Release 1.12</td>
- *      <td>\ref H5Oget_info3()</td>
+ *      <td>#H5Oget_info3</td>
  *  </tr>
  *  <tr>
  *      <td>Emulate Release 1.10/1.8 interface</td>
- *      <td>\ref H5Oget_info1()</td>
+ *      <td>#H5Oget_info1</td>
  *  </tr>
  * </table>
  *
  * \note    If you are iterating through a lot of different objects to
- *          retrieve information via the H5Oget_info() family of routines,
+ *          retrieve information via the #H5Oget_info family of routines,
  *          you may see memory building up. This can be due to memory
  *          allocation for metadata such as object headers and messages
  *          when the iterated objects are put into the metadata cache.
  * \note
  *          If the memory buildup is not desirable, you can configure a
- *          smaller cache via H5Fset_mdc_config() or set the file access
- *          property list via H5Pset_mdc_config(). A smaller sized cache
+ *          smaller cache via #H5Fset_mdc_config or set the file access
+ *          property list via #H5Pset_mdc_config. A smaller sized cache
  *          will force metadata entries to be evicted from the cache,
  *          thus freeing the memory associated with the entries.
  *
- * \todo    Fix reference to the document
+ * \version 1.12.0 The macro #H5Oget_info and the function #H5Oget_info3 
+ *                 were added, and #H5Oget_info1 was deprecated.
+ * \version 1.10.5 The macro #H5Oget_info was removed.  The functions 
+ *                 #H5Oget_info1 and #H5Oget_info are identical 
+ *                 in this release.  This change was added to restore the 
+ *                 broken API compatibility introduced in HDF5-1.10.3.
+ * \version 1.10.3 The function #H5Oget_info was renamed 
+ *                 #H5Oget_info1.  The macro #H5Oget_info and the function 
+ *                 #H5Oget_info2 were introduced in this release.
+ * \version 1.8.15 Added a note about the valid values for the \c version field 
+ *                 in the H5O_hdr_info_t structure.
+ * \version 1.8.11 Fortran subroutine introduced in this release.
+ * \version 1.8.10 Added #H5O_type_t structure to the Description section.
+ *                 Separated H5O_hdr_info_t structure from 
+ *                 #H5O_info_t in the Description section.  Clarified the 
+ *                 definition and implementation of the time fields.
  *
- * \par Version
- * <table>
- * <tr>
- *      <th>Release</th>
- *      <th>Change</th>
- * </tr>
- *  <tr>
- *      <td>1.12.0</td>
- *      <td>The macro #H5Oget_info and the function \ref H5Oget_info3() were added, 
- *          and \ref H5Oget_info1() was deprecated.</td>
- *  </tr>
- *  <tr>
- *      <td>1.10.5</td>
- *      <td>The macro #H5Oget_info was removed.</td>
- *  </tr>
- *  <tr>
- *      <td></td>
- *      <td>The functions \ref H5Oget_info1() and
- *          #H5Oget_info are identical in this release.</td>
- *  </tr>
- *  <tr>
- *      <td></td>
- *      <td>This change was added to restore the broken API compatibility 
- *          introduced in HDF5-1.10.3.</td>
- *  </tr>
- *  <tr>
- *      <td>1.10.3</td>
- *      <td>The function \ref H5Oget_info() was renamed \ref H5Oget_info1.</td>
- *  </tr>
- *  <tr>
- *      <td></td>
- *      <td>The macro #H5Oget_info and the function \ref H5Oget_info2() were 
- *          introduced in this release.</td>
- *  </tr>
- *  <tr>
- *      <td>1.8.15</td>
- *      <td>Added a note about the valid values for the \c version field in 
- *          the \ref H5O_hdr_info_t structure.</td>
- *  </tr>
- *  <tr>
- *      <td>1.8.11</td>
- *      <td>Fortran subroutine introduced in this release.</td>
- *  </tr>
- *  <tr>
- *      <td>1.8.10</td>
- *      <td>Added \ref H5O_type_t structure to the Description section.</td>
- *  </tr>
- *  <tr>
- *      <td></td>
- *      <td>Separated \ref H5O_hdr_info_t structure from \ref H5O_info_t 
- *          in the Description section.</td>
- *  </tr>
- *  <tr>
- *      <td></td>
- *      <td>Clarified the definition and implementation of the time fields.</td>
- *  </tr>
- *  <tr>
- *      <td>1.8.0</td>
- *      <td>Function introduced in this release.</td>
- *  </tr>
- * </table>
+ * \since 1.8.0
  *
- * 
  */