summaryrefslogtreecommitdiffstats
path: root/release_docs
diff options
context:
space:
mode:
authorAllen Byrne <50328838+byrnHDF@users.noreply.github.com>2024-01-29 13:38:54 (GMT)
committerGitHub <noreply@github.com>2024-01-29 13:38:54 (GMT)
commit365e23340cd001ee751da366235ae420156ad728 (patch)
tree49d5a73db00b4eb8ecdd8c872027f58265e18ba4 /release_docs
parent1bea9e6100fd7c92caf31eba96766aa8ec4f356c (diff)
downloadhdf5-365e23340cd001ee751da366235ae420156ad728.zip
hdf5-365e23340cd001ee751da366235ae420156ad728.tar.gz
hdf5-365e23340cd001ee751da366235ae420156ad728.tar.bz2
Fix doxygen errors (#3962)
* Switch warnings as errors to default OFF * Enable mac docs * Add doxygen action uses step * Use html div around snippet * Allow preset name to be an argument to cmake-ctest.yml
Diffstat (limited to 'release_docs')
-rw-r--r--release_docs/INSTALL_CMake.txt2
-rw-r--r--release_docs/RELEASE.txt9
2 files changed, 10 insertions, 1 deletions
diff --git a/release_docs/INSTALL_CMake.txt b/release_docs/INSTALL_CMake.txt
index f9184cf..6adba9f 100644
--- a/release_docs/INSTALL_CMake.txt
+++ b/release_docs/INSTALL_CMake.txt
@@ -872,7 +872,7 @@ HDF5_ENABLE_ANALYZER_TOOLS "enable the use of Clang tools"
HDF5_ENABLE_SANITIZERS "execute the Clang sanitizer" OFF
HDF5_ENABLE_FORMATTERS "format source files" OFF
HDF5_BUILD_DOC "Build documentation" OFF
-HDF5_ENABLE_DOXY_WARNINGS "Enable fail if doxygen parsing has warnings." ON
+HDF5_ENABLE_DOXY_WARNINGS "Enable fail if doxygen parsing has warnings." OFF
---------------- HDF5 VFD Options ---------------------
HDF5_ENABLE_DIRECT_VFD "Build the Direct I/O Virtual File Driver" OFF
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index 19c309b..de02a66 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -931,6 +931,15 @@ Bug Fixes since HDF5-1.14.0 release
Configuration
-------------
+ - Changed default of 'Error on HDF5 doxygen warnings' DOXYGEN_WARN_AS_ERROR option.
+
+ The default setting of DOXYGEN_WARN_AS_ERROR to 'FAIL_ON_WARNINGS' has been changed
+ to 'NO'. It was decided that the setting was too aggressive and should be a user choice.
+ The github actions and scripts have been updated to reflect this.
+
+ * HDF5_ENABLE_DOXY_WARNINGS: ON/OFF (Default: OFF)
+ * --enable-doxygen-errors: enable/disable (Default: disable)
+
- Removed an Autotools configure hack that causes problems on MacOS
A sed line in configure.ac was added in the past to paper over some