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" +
0xffff...ff.
\anchor FMT11UnlimitedDim The "unlimited size" for a size is a value with all bits set,
i.e. 0xffff...ff.
+| RFC ID | Title |
|---|---|
| 2022-08-19 | \ref_rfc20220819 |
| 2004-08-11 | \ref_rfc20040811 |
+H5_term_library for more information.
+* This code is the called by Java programs to access the entry points of the HDF5 library. Each routine wraps diff --git a/java/src/hdf/hdf5lib/HDF5Constants.java b/java/src/hdf/hdf5lib/HDF5Constants.java index 57f653865da..05ed9b5a3ca 100644 --- a/java/src/hdf/hdf5lib/HDF5Constants.java +++ b/java/src/hdf/hdf5lib/HDF5Constants.java @@ -15,7 +15,7 @@ package hdf.hdf5lib; import hdf.hdf5lib.structs.H5O_token_t; /** - * @page HDF5CONST Constants and Enumerated Types + * \page HDF5CONST Constants and Enumerated Types * This class contains C constants and enumerated types of HDF5 library. The * values of these constants are obtained from the library by calling * the JNI function jconstant, where jconstant is used for any of the private constants diff --git a/java/src/hdf/hdf5lib/HDFArray.java b/java/src/hdf/hdf5lib/HDFArray.java index 15072cabdda..888e0641fc5 100644 --- a/java/src/hdf/hdf5lib/HDFArray.java +++ b/java/src/hdf/hdf5lib/HDFArray.java @@ -18,7 +18,7 @@ import hdf.hdf5lib.exceptions.HDF5Exception; import hdf.hdf5lib.exceptions.HDF5JavaException; /** - * @page HDFARRAY Java Array Conversion + * \page HDFARRAY Java Array Conversion * This is a class for handling multidimensional arrays for HDF. *
* The purpose is to allow the storage and retrieval of arbitrary array types containing scientific data. diff --git a/java/src/hdf/hdf5lib/HDFNativeData.java b/java/src/hdf/hdf5lib/HDFNativeData.java index a6155ca2a65..9a4b8395c3b 100644 --- a/java/src/hdf/hdf5lib/HDFNativeData.java +++ b/java/src/hdf/hdf5lib/HDFNativeData.java @@ -16,7 +16,7 @@ import hdf.hdf5lib.exceptions.HDF5Exception; import hdf.hdf5lib.exceptions.HDF5JavaException; /** - * @page HDFNATIVE Native Arrays of Numbers + * \page HDFNATIVE Native Arrays of Numbers * This class encapsulates native methods to deal with arrays of numbers, * converting from numbers to bytes and bytes to numbers. *
diff --git a/java/src/hdf/hdf5lib/callbacks/H5Callbacks.java b/java/src/hdf/hdf5lib/callbacks/H5Callbacks.java index d0af5c81e32..8f3748ead3f 100644 --- a/java/src/hdf/hdf5lib/callbacks/H5Callbacks.java +++ b/java/src/hdf/hdf5lib/callbacks/H5Callbacks.java @@ -13,7 +13,7 @@ package hdf.hdf5lib.callbacks; /** - * @page CALLBACKS HDF5 Java H5Callbacks Interface + * \page CALLBACKS HDF5 Java H5Callbacks Interface * All callback definitions must derive from this interface. Any * derived interfaces must define a single public method named "callback". * You are responsible for deregistering your callback (if necessary) diff --git a/java/src/hdf/hdf5lib/callbacks/package-info.java b/java/src/hdf/hdf5lib/callbacks/package-info.java index f0cefdfca78..a0013abcc24 100644 --- a/java/src/hdf/hdf5lib/callbacks/package-info.java +++ b/java/src/hdf/hdf5lib/callbacks/package-info.java @@ -11,7 +11,7 @@ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ /** - * @page CALLBACKS_UG HDF5 Java H5Callbacks Interface + * \page CALLBACKS_UG HDF5 Java H5Callbacks Interface * All callback definitions must derive from the H5Callbacks interface. Any * derived interfaces must define a single public method named "callback". * You are responsible for deregistering your callback (if necessary) diff --git a/java/src/hdf/hdf5lib/exceptions/HDF5Exception.java b/java/src/hdf/hdf5lib/exceptions/HDF5Exception.java index 403c7684ac6..9a22ee8d6f5 100644 --- a/java/src/hdf/hdf5lib/exceptions/HDF5Exception.java +++ b/java/src/hdf/hdf5lib/exceptions/HDF5Exception.java @@ -13,7 +13,7 @@ package hdf.hdf5lib.exceptions; /** - * @page ERRORS Errors and Exceptions + * \page ERRORS Errors and Exceptions * The class HDF5Exception returns errors from the Java HDF5 Interface. * * Two sub-classes of HDF5Exception are defined: diff --git a/java/src/hdf/hdf5lib/exceptions/HDF5JavaException.java b/java/src/hdf/hdf5lib/exceptions/HDF5JavaException.java index 65f4667249e..2d0b3a33582 100644 --- a/java/src/hdf/hdf5lib/exceptions/HDF5JavaException.java +++ b/java/src/hdf/hdf5lib/exceptions/HDF5JavaException.java @@ -13,7 +13,7 @@ package hdf.hdf5lib.exceptions; /** - * @page ERRORSJAVA Java Wrapper Errors and Exceptions + * \page ERRORSJAVA Java Wrapper Errors and Exceptions * The class HDF5JavaException returns errors from the Java wrapper of theHDF5 * library. *
diff --git a/java/src/hdf/hdf5lib/exceptions/HDF5LibraryException.java b/java/src/hdf/hdf5lib/exceptions/HDF5LibraryException.java index 31d29b2ca2b..442867c09c8 100644 --- a/java/src/hdf/hdf5lib/exceptions/HDF5LibraryException.java +++ b/java/src/hdf/hdf5lib/exceptions/HDF5LibraryException.java @@ -16,7 +16,7 @@ import hdf.hdf5lib.H5; import hdf.hdf5lib.HDF5Constants; /** - * @page ERRORSLIB HDF5 Library Errors and Exceptions + * \page ERRORSLIB HDF5 Library Errors and Exceptions * The class HDF5LibraryException returns errors raised by the HDF5 library. * * Each major error code from the HDF5 Library is represented by a sub-class of diff --git a/java/src/hdf/hdf5lib/exceptions/package-info.java b/java/src/hdf/hdf5lib/exceptions/package-info.java index f7e229444e5..1a3cbddcb81 100644 --- a/java/src/hdf/hdf5lib/exceptions/package-info.java +++ b/java/src/hdf/hdf5lib/exceptions/package-info.java @@ -11,7 +11,7 @@ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ /** - * @page ERRORS_UG Errors and Exceptions + * \page ERRORS_UG Errors and Exceptions *
* The package exceptions contains error classes for the Java HDF5 Interface. *
diff --git a/java/src/hdf/hdf5lib/package-info.java b/java/src/hdf/hdf5lib/package-info.java index 34efe584fde..bf0a8137bd4 100644 --- a/java/src/hdf/hdf5lib/package-info.java +++ b/java/src/hdf/hdf5lib/package-info.java @@ -11,7 +11,7 @@ * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ /** - @page HDF5LIB_UG HDF5 Java Package + \page HDF5LIB_UG HDF5 Java Package * This package is the Java interface for the HDF5 library. *
* This code is the called by Java programs to access the entry points of the HDF5 library. diff --git a/src/H5Amodule.h b/src/H5Amodule.h index 7e0e2bb76e7..c95964bb63c 100644 --- a/src/H5Amodule.h +++ b/src/H5Amodule.h @@ -27,6 +27,9 @@ #define H5_MY_PKG_INIT YES /** \page H5A_UG HDF5 Attributes + * + * Navigate back: \ref index "Main" / \ref UG + *