Sphinx 8.1.0 got a lot better at detecting unreferenced footnotes, and we have three of them---which causes the build to fail when the latest version of sphinx is installed from Pip.
Patches 1 and 2 fix them, while the third is a general improvement in the appearance of the rendered footnotes and the consistency of the rST syntax. An example of a failing job is https://gitlab.com/bonzini/qemu/-/jobs/8060240732. Paolo v1->v2: improve commit messages replace patch 2, absorbing the rapl-msr.rst changes into it Paolo Bonzini (3): docs: fix invalid footnote syntax docs: avoid footnotes consisting of just URLs docs: use consistent markup for footnotes docs/devel/atomics.rst | 6 +++--- docs/devel/build-system.rst | 6 +++--- docs/devel/loads-stores.rst | 2 +- docs/devel/maintainers.rst | 4 ++-- docs/devel/migration/mapped-ram.rst | 4 ++-- docs/devel/testing/acpi-bits.rst | 26 +++++++++++++------------- docs/specs/fw_cfg.rst | 4 ++-- docs/specs/rapl-msr.rst | 25 ++++++++++++------------- 8 files changed, 38 insertions(+), 39 deletions(-) -- 2.46.2