Skip to content

COMP: Track ITKDoxygen latest artifacts; revert doxygen warning suppression#458

Merged
hjmjohnson merged 3 commits into
InsightSoftwareConsortium:mainfrom
hjmjohnson:update-doxygen-xml-6.0b01
Jun 13, 2026
Merged

COMP: Track ITKDoxygen latest artifacts; revert doxygen warning suppression#458
hjmjohnson merged 3 commits into
InsightSoftwareConsortium:mainfrom
hjmjohnson:update-doxygen-xml-6.0b01

Conversation

@hjmjohnson

@hjmjohnson hjmjohnson commented Jun 12, 2026

Copy link
Copy Markdown
Member

Reverts the warning-suppression commit from #456 and fixes the root cause: the docs build pulled Doxygen XML/HTML/tag pinned to v5.3.0 (2022), whose Doxygen run lacked several class compounds. The downloads now track the ITKDoxygen latest release, which rebuilds nightly from ITK main and (since ITKDoxygen#43/#45) publishes the complete Html+Xml+DocTag set with the VTK/OpenCV bridge classes. Zero doxygen-lookup warning exceptions remain. Part 3 of InsightSoftwareConsortium/ITK#6439.

Details
  • git revert 9ca80aa4 — withdraws the doxygenclass/tag-lookup warning exemptions.
  • Download{DoxygenXML,Doxygen,DoxygenTAG}.cmake: v5.3.0 pins → ITKDoxygen latest (the examples build ITK main, so tracking the nightly artifact is more correct than any immutable release pin).
  • IterateOnAVectorContainer: breathelink updated to itk::detail::VectorContainer (the class moved to the detail namespace in ITK 6; the public name is an alias and has no doxygen compound).
  • Re-applies the two genuine rst fixes from the reverted commit (short title underline; FFT output block lexed as text).

Verified: all three latest asset URLs return 200, and the fresh XML contains AddImageFilter, Statistics::SampleToHistogramFilter, ImageToVTKImageFilter, VTKImageToImageFilter, and OpenCVImageBridge.

@github-actions github-actions Bot added type:Compiler Compiler support or related warnings type:Infrastructure Infrastructure/ecosystem related changes, such as CMake or buildbots labels Jun 12, 2026
@hjmjohnson

Copy link
Copy Markdown
Member Author

Part 3 of the plan in InsightSoftwareConsortium/ITK#6439 — after ITKDoxygen#43 lands and a nightly completes, this PR should switch the downloads to the ITKDoxygen latest release and drop the remaining lookup exception.

@hjmjohnson hjmjohnson marked this pull request as ready for review June 12, 2026 15:12
@hjmjohnson hjmjohnson force-pushed the update-doxygen-xml-6.0b01 branch from 846e082 to acd904a Compare June 13, 2026 00:24
The v5.3.0-pinned XML and tag predate several class compounds
(AddImageFilter, SampleToHistogramFilter, the VTK and OpenCV bridge
classes), breaking breathelink lookups now that examples document
against ITK main. The ITKDoxygen latest release rebuilds nightly from
ITK main and now publishes the complete artifact set including the
DocTag. VectorContainer moved to the itk::detail namespace in ITK 6.
@hjmjohnson hjmjohnson force-pushed the update-doxygen-xml-6.0b01 branch from acd904a to 51f986d Compare June 13, 2026 01:01
@github-actions github-actions Bot added area:Core Issues affecting the Core module area:Documentation Issues affecting the Documentation module labels Jun 13, 2026
@hjmjohnson hjmjohnson changed the title COMP: Update Doxygen artifacts to v6.0b01; revert doxygenclass warning suppression COMP: Track ITKDoxygen latest artifacts; revert doxygen warning suppression Jun 13, 2026
@hjmjohnson hjmjohnson merged commit 4a95585 into InsightSoftwareConsortium:main Jun 13, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:Core Issues affecting the Core module area:Documentation Issues affecting the Documentation module type:Compiler Compiler support or related warnings type:Infrastructure Infrastructure/ecosystem related changes, such as CMake or buildbots

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants