From 84028437b04be804d5d871d0ed48a8a5b0b4871b Mon Sep 17 00:00:00 2001 From: Allen Byrne <50328838+byrnHDF@users.noreply.github.com> Date: Fri, 2 May 2025 12:20:18 -0500 Subject: [PATCH] Add navigation links to doxygen pages (#5498) * Add navigation links to doxygen pages * Fix missing link and revert merge issues --- c++/src/C2Cppfunction_map.htm | 2 +- doxygen/dox/About.dox | 5 ++++ doxygen/dox/AppDbgging.dox | 6 +++++ doxygen/dox/CollectiveCalls.dox | 8 +++++- doxygen/dox/CollectiveMetadataIO.dox | 7 ++++++ doxygen/dox/Cookbook.dox | 6 +++++ doxygen/dox/CopyingCommited.dox | 6 +++++ doxygen/dox/DDLBNF110.dox | 6 +++++ doxygen/dox/DDLBNF112.dox | 6 +++++ doxygen/dox/DDLBNF114.dox | 6 +++++ doxygen/dox/DDLBNF200.dox | 6 +++++ doxygen/dox/ExamplesAPI.dox | 2 +- doxygen/dox/FTS.dox | 6 +++++ doxygen/dox/FileFormatDisc.dox | 6 +++++ ...FreeingMemoryAllocatedByTheHdf5Library.dox | 7 ++++++ doxygen/dox/GettingStarted.dox | 2 +- doxygen/dox/Glossary.dox | 6 +++++ doxygen/dox/H5.format.1.0.dox | 7 ++++++ doxygen/dox/H5.format.1.1.dox | 7 ++++++ doxygen/dox/H5.format.2.0.dox | 7 ++++++ doxygen/dox/H5.format.3.0.dox | 7 ++++++ .../dox/HDF5CompressionTroubleshooting.dox | 7 ++++++ ...provingIOPerformanceCompressedDatasets.dox | 7 ++++++ doxygen/dox/IOFlow.dox | 7 ++++++ doxygen/dox/ImageSpec.dox | 5 ++++ doxygen/dox/IntroHDF5.dox | 11 ++++++-- doxygen/dox/IntroParExamples.dox | 8 +++--- doxygen/dox/IntroParHDF5.dox | 2 +- doxygen/dox/LearnBasics.dox | 4 +-- doxygen/dox/LearnBasics1.dox | 14 +++++------ doxygen/dox/LearnBasics2.dox | 10 ++++---- doxygen/dox/LearnBasics3.dox | 16 ++++++------ doxygen/dox/LearnHDFView.dox | 2 +- doxygen/dox/MetadataCachingInHDF5.dox | 6 +++++ doxygen/dox/ModifiedRegionWrites.dox | 6 +++++ doxygen/dox/PredefinedDatatypeTables.dox | 25 ++++++++++++------- doxygen/dox/RFC.dox | 6 +++++ doxygen/dox/ReferenceManual.dox | 6 +++++ doxygen/dox/RelVersion.dox | 7 ++++++ doxygen/dox/SWMRTechNote.dox | 6 +++++ doxygen/dox/Specifications.dox | 6 +++++ doxygen/dox/TableSpec.dox | 6 +++++ doxygen/dox/TechnicalNotes.dox | 6 +++++ doxygen/dox/ThreadSafe.dox | 6 +++++ doxygen/dox/Tools.dox | 7 +++--- doxygen/dox/TrainingVideos.dox | 2 +- doxygen/dox/Unicode.dox | 6 +++++ doxygen/dox/UsersGuide.dox | 20 ++++++++++++--- doxygen/dox/UsingIdentifiers.dox | 6 +++++ doxygen/dox/VDSTechNote.dox | 6 +++++ doxygen/dox/VFLTechNote.dox | 6 +++++ doxygen/dox/VOLConnGuide.dox | 4 +-- doxygen/dox/ViewTools.dox | 6 ++--- doxygen/dox/ViewTools2.dox | 4 +-- doxygen/dox/ViewToolsJPSS.dox | 2 +- doxygen/dox/api-compat-macros.dox | 6 +++++ doxygen/dox/branches-explained.dox | 6 +++++ doxygen/dox/chunking_in_hdf5.dox | 6 +++++ doxygen/dox/cmake-vols-fetchcontent.dox | 6 +++++ doxygen/dox/code-conventions.dox | 6 +++++ doxygen/dox/cookbook/Accessibility.dox | 6 +++++ doxygen/dox/cookbook/Attributes.dox | 6 +++++ doxygen/dox/cookbook/Files.dox | 6 +++++ doxygen/dox/cookbook/Performance.dox | 6 +++++ doxygen/dox/cookbook/Presets.dox | 6 +++++ doxygen/dox/file-locking.dox | 6 +++++ doxygen/dox/hdf5_1_10.dox | 8 +++++- doxygen/dox/hdf5_1_12.dox | 8 +++++- doxygen/dox/hdf5_1_14.dox | 7 ++++++ doxygen/dox/hdf5_1_8.dox | 7 ++++++ doxygen/dox/high_level/extension.dox | 6 +++++ doxygen/dox/library-init-shutdown.dox | 6 +++++ doxygen/dox/parallel-compression.dox | 6 +++++ doxygen/dox/release_specific_info.dox | 8 +++++- doxygen/dox/rm-template.dox | 6 +++++ doxygen/dox/sw_changes_1.10.dox | 6 +++++ doxygen/dox/sw_changes_1.12.dox | 6 +++++ doxygen/dox/sw_changes_1.14.dox | 6 +++++ doxygen/dox/threadsafety-warning.dox | 9 ++++++- hl/src/H5DOpublic.h | 9 +++++++ hl/src/H5DSpublic.h | 9 +++++++ hl/src/H5IMpublic.h | 11 ++++++++ hl/src/H5LTpublic.h | 11 ++++++++ hl/src/H5PTpublic.h | 11 ++++++++ hl/src/H5TBpublic.h | 11 ++++++++ hl/tools/h5watch/h5watch.h | 8 ++++++ java/src/hdf/hdf5lib/H5.java | 2 +- java/src/hdf/hdf5lib/HDF5Constants.java | 2 +- java/src/hdf/hdf5lib/HDFArray.java | 2 +- java/src/hdf/hdf5lib/HDFNativeData.java | 2 +- .../hdf/hdf5lib/callbacks/H5Callbacks.java | 2 +- .../hdf/hdf5lib/callbacks/package-info.java | 2 +- .../hdf/hdf5lib/exceptions/HDF5Exception.java | 2 +- .../hdf5lib/exceptions/HDF5JavaException.java | 2 +- .../exceptions/HDF5LibraryException.java | 2 +- .../hdf/hdf5lib/exceptions/package-info.java | 2 +- java/src/hdf/hdf5lib/package-info.java | 2 +- src/H5Amodule.h | 6 +++++ src/H5Dmodule.h | 6 +++++ src/H5ESmodule.h | 7 ++++++ src/H5Emodule.h | 6 +++++ src/H5Fmodule.h | 12 +++++++++ src/H5Gmodule.h | 6 +++++ src/H5Imodule.h | 7 ++++++ src/H5Lmodule.h | 7 ++++++ src/H5Mmodule.h | 9 ++++++- src/H5Omodule.h | 7 ++++++ src/H5PLmodule.h | 8 ++++++ src/H5Pmodule.h | 10 +++++++- src/H5Rmodule.h | 8 ++++++ src/H5Smodule.h | 7 +++++- src/H5Tmodule.h | 6 +++++ src/H5VLmodule.h | 6 +++++ src/H5Zmodule.h | 7 ++++++ src/H5module.h | 12 +++++++++ tools/src/h5copy/h5copy.h | 8 ++++++ tools/src/h5diff/h5diff_main.h | 8 ++++++ tools/src/h5dump/h5dump.h | 8 ++++++ tools/src/h5format_convert/h5format_convert.h | 8 ++++++ tools/src/h5import/h5import.h | 8 ++++++ tools/src/h5jam/h5jam.h | 8 ++++++ tools/src/h5ls/h5ls.h | 8 ++++++ tools/src/h5repack/h5repack.h | 8 ++++++ tools/src/h5stat/h5stat.h | 8 ++++++ tools/src/misc/h5clear.h | 8 ++++++ tools/src/misc/h5debug.h | 8 ++++++ tools/src/misc/h5delete.h | 8 ++++++ tools/src/misc/h5mkgrp.h | 8 ++++++ tools/src/misc/h5repart.h | 8 ++++++ 129 files changed, 788 insertions(+), 77 deletions(-) diff --git a/c++/src/C2Cppfunction_map.htm b/c++/src/C2Cppfunction_map.htm index 791892ee006..a6e0ef09b22 100644 --- a/c++/src/C2Cppfunction_map.htm +++ b/c++/src/C2Cppfunction_map.htm @@ -1044,7 +1044,7 @@ span.msoDel {mso-style-type:export-only; margin-bottom:8.0pt; line-height:107%;} -@page WordSection1 +\page WordSection1 {size:11.0in 8.5in; mso-page-orientation:landscape; margin:1.0in 1.0in 1.0in 1.0in; diff --git a/doxygen/dox/About.dox b/doxygen/dox/About.dox index 7ae4c71307b..3cc80011064 100644 --- a/doxygen/dox/About.dox +++ b/doxygen/dox/About.dox @@ -1,5 +1,8 @@ /** \page About About +Navigate back: \ref index "Main" +
+ \section about_history History The implementation of this documentation set is based on the fantastic work of the @@ -113,4 +116,6 @@ be https://\RFCURL/my_great_rfc_name.pdf \endverbatim +
+Navigate back: \ref index "Main" */ diff --git a/doxygen/dox/AppDbgging.dox b/doxygen/dox/AppDbgging.dox index d009b01ab54..35c3b2e4d9a 100644 --- a/doxygen/dox/AppDbgging.dox +++ b/doxygen/dox/AppDbgging.dox @@ -1,6 +1,9 @@ /** \page APPDBG Debugging HDF5 Applications +Navigate back: \ref index "Main" / \ref TN +
+ \section sec_adddbg_intro Introduction The HDF5 library contains a number of debugging features to make programmers' lives easier including the ability to print detailed error messages, check invariant @@ -155,4 +158,7 @@ and spaces is sent to file descriptor 255 which should be redirected by the shel The components of the HDF5_DEBUG value may be separated by any non-lowercase letter. +
+Navigate back: \ref index "Main" / \ref TN + */ diff --git a/doxygen/dox/CollectiveCalls.dox b/doxygen/dox/CollectiveCalls.dox index 9fb7229a3ca..3571e373fce 100644 --- a/doxygen/dox/CollectiveCalls.dox +++ b/doxygen/dox/CollectiveCalls.dox @@ -1,4 +1,7 @@ /** \page collective_calls Collective Calling Requirements in Parallel HDF5 Applications + * + * Navigate back: \ref index "Main" / \ref GettingStarted / \ref IntroParHDF5 + *
* * \section sec_collective_calls_intro Introduction * This document addresses two topics of concern @@ -1261,5 +1264,8 @@ - + * + *
+ * Navigate back: \ref index "Main" / \ref GettingStarted / \ref IntroParHDF5 + * */ diff --git a/doxygen/dox/CollectiveMetadataIO.dox b/doxygen/dox/CollectiveMetadataIO.dox index 49332b2d978..958025b6493 100644 --- a/doxygen/dox/CollectiveMetadataIO.dox +++ b/doxygen/dox/CollectiveMetadataIO.dox @@ -1,4 +1,8 @@ /** \page collective_metadata_io Collective Metadata I/O + * + * Navigate back: \ref index "Main" / \ref TN + *
+ * * The purpose of this page is to briefly describe the new HDF5 Collective Metadata I/O feature and * provide a gateway to available documentation. The page includes the following sections: *