Skip to content

extlinks: add replacement pattern to captions, required from Sphinx v6.0 onwards

James Addison requested to merge (removed):bug-1094000/update-extlink-captions into master

From Sphinx 6.0 onwards, extlinks captions must contain the same pattern replacements as their corresponding URLs, or alternatively be set to empty/None (in which case the emitted links use the complete URL as the hyperlink title).

This change configures the captions to be substituted with the replacement pattern and no other content, causing manual page references in release-notes to use the name of the referenced manual page as the hyperlink title.

This enables the release-notes to build successfully in Debian trixie (where Sphinx v8.1.3 is currently included at the time-of-writing). I've also tested that this is backwards-compatible to Debian bookworm, where it does not affect the HTML output.

Closes: #1094000

Merge request reports