Skip to content

Conversation

@brtnfld
Copy link
Collaborator

@brtnfld brtnfld commented Nov 26, 2025

Fixes #3105
Adds missing (i.e. todo) user guide documentation for:

Virtual File Drivers
VOL connectors
Map objects
Object interface, links, identifiers, filters
High-level APIs

Fixes #6050
Fixes table rendering issues.

Fixes #3006
Fix grammar in documentation block of H5FDioc.c and improve consistency.


Important

Added missing user guide documentation for various HDF5 components and fixed table rendering issues.

  • Documentation:
    • Added missing user guide documentation for Virtual File Drivers, VOL connectors, Map objects, Object interface, links, identifiers, filters, and high-level APIs in doxygen/dox/UsersGuide.dox.
    • Updated hl/src/H5DOpublic.h, hl/src/H5DSpublic.h, hl/src/H5IMpublic.h, hl/src/H5LTpublic.h, hl/src/H5PTpublic.h, hl/src/H5TBpublic.h, src/H5ESmodule.h, src/H5FDmodule.h, src/H5Imodule.h, src/H5Lmodule.h, src/H5Mmodule.h, src/H5Omodule.h, src/H5Pmodule.h, src/H5VLmodule.h, and src/H5Zmodule.h with detailed sections on their respective functionalities.
  • Rendering:
    • Fixed table rendering issues in hl/src/H5DSpublic.h.

This description was created by Ellipsis for 8e7c960. You can customize this summary. It will automatically update as commits are pushed.

jhendersonHDF
jhendersonHDF previously approved these changes Dec 5, 2025
@brtnfld brtnfld self-assigned this Dec 5, 2025
  * H5Smodule.h: Add dataspace selection and data transfer documentation
  * H5module.h: Add link types and organization documentation
  * H5Emodule.h: Add error handling programming model documentation
@brtnfld brtnfld moved this from To be triaged to In progress in HDF5 - TRIAGE & TRACK Dec 5, 2025
jhendersonHDF
jhendersonHDF previously approved these changes Dec 5, 2025
jhendersonHDF
jhendersonHDF previously approved these changes Dec 5, 2025
@brtnfld
Copy link
Collaborator Author

brtnfld commented Dec 8, 2025

@lrknox, waiting for your review

src/H5ESmodule.h Outdated
* <tr>
* <th>H5R</th>
* <td>#H5Ropen_attr, #H5Ropen_object #H5Ropen_region, #H5Rdereference
* <td>#H5Ropen_attr, #H5Ropen_object #H5Ropen_region
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* <td>#H5Ropen_attr, #H5Ropen_object #H5Ropen_region
* <td>#H5Ropen_attr, #H5Ropen_object #H5Ropen_region,

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

comma should be after #H5Ropen_object

lrknox
lrknox previously approved these changes Dec 8, 2025
@lrknox lrknox merged commit d3cebd7 into HDFGroup:develop Dec 8, 2025
41 of 88 checks passed
@github-project-automation github-project-automation bot moved this from In progress to Done in HDF5 - TRIAGE & TRACK Dec 8, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Component - Documentation Doxygen, markdown, etc.

Projects

Status: Done

4 participants