[garyo]

The "Properties on the Image Effect Host" link on the OfxHost struct page goes nowhere, and so do about 60 other cross-references in the Reference docs. Documentation/build.sh filtered "undefined label" out of the Sphinx warnings it prints, so nobody saw them.

Causes and fixes

"Properties on ..." links (10). The OfxHost struct and Image Effect API pages linked to labels such as ImageEffectHostProperties. The old properties-by-object page wrote those as .. ImageEffectHostProperties:, an RST comment rather than a label, so the links were dead even before #267 removed that page. They now go to the matching section of the generated Property Sets reference, and the parameters link goes to that page as a whole, since it has one set per parameter type.

Multi-type properties (44). gen-props-doc.py wrote kOfxParamPropDefault, Min, Max, DisplayMin and DisplayMax once per type section, each time with the same label. Sphinx drops a label defined more than once, so every link to them failed. They now appear once, in a "Properties with Multiple Types" section. The generator also sized heading underlines to the name without its ** markup (about 500 "Title underline too short" warnings); a small rst_heading() helper fixes that.

Other pages (9, plus one enum). Eighteen pages used the same .. Name: comment form for labels; these are now real labels, which fixes the links to CoordinateSystems and ImageEffectsMultiThreadingRendering. The rest now point at labels that exist (mainEntryPoint, threadRecursionSafety, ParameterPropertiesDoubleTypesStrictlySpatial, the kOfxParamPropDoubleType macro). The Draw Suite page asked for OfxDrawTextAligment, so the text-alignment enum was missing from the docs.

Doxygen lists and duplicate targets. Two header comments (kOfxImageEffectPropSupportsMultiResolution, kOfxImageEffectPropMetalTextureEnabled) indented a lead-in list deeper than the "Valid Values" list after it, which Doxygen rejects; the lead-in lists are now sentences. ofxRendering.rst pulled in three field macros twice; the second list now refers to the first.

build.sh no longer hides "undefined label" warnings. With these fixes the build has none.

Verification

Built with Documentation/build.sh: no undefined-label, duplicate-label or underline warnings remain, and the rendered pages link to the right sections (checked in the HTML). The remaining warnings are C++ declarator errors for the suites' function-pointer members. They come from Doxygen 1.18.0, which changed how it writes those members to XML; Read the Docs uses an older Doxygen and is not affected. build.sh now warns when it finds Doxygen 1.18 or later.

Assisted-by: Claude Code / Claude Opus 5.5