On 09/09/2026 11:00, Peter Maydell wrote:
On Wed, 9 Sept 2026 at 10:56, Mark Cave-Ayland
<[email protected]> wrote:
On 06/09/2026 23:29, Brian Cain wrote:
pythondeps.toml and docs/requirements.txt pin sphinx==7.2.6 alongside
sphinx_rtd_theme==1.2.2, but 1.2.2 requires sphinx<7 on PyPI.
A fresh install of the docs group silently downgrades Sphinx to 6.2.1 to
satisfy that cap, which then fails Sphinx's own >=7.2.6 runtime check
in docs/meson.build.
sphinx_rtd_theme==2.0.0 is the first release that drops the sphinx<7 cap
and resolves cleanly against sphinx==7.2.6.
Signed-off-by: Brian Cain <[email protected]>
---
docs/requirements.txt | 2 +-
pythondeps.toml | 2 +-
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/requirements.txt b/docs/requirements.txt
index c10c4cf7c91..509d56bd1e8 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -2,4 +2,4 @@
# Should be in sync with the "installed" key of pythondeps.toml
sphinx==7.2.6
-sphinx_rtd_theme==1.2.2
+sphinx_rtd_theme==2.0.0
diff --git a/pythondeps.toml b/pythondeps.toml
index e4c10d4a9f7..afb1364dd28 100644
--- a/pythondeps.toml
+++ b/pythondeps.toml
@@ -29,7 +29,7 @@ meson = { accepted = ">=1.12.0", installed = "1.12.0", canary =
"meson" }
[docs]
# Please keep the installed versions in sync with docs/requirements.txt
sphinx = { accepted = ">=7.2.6", installed = "7.2.6", canary =
"sphinx-build" }
-sphinx_rtd_theme = { accepted = ">=1.2.2", installed = "1.2.2" }
+sphinx_rtd_theme = { accepted = ">=1.2.2", installed = "2.0.0" }
# This test group is for dependencies required to run various tooling
# and tests that should always be installed at configure time. It should
Reviewed-by: Mark Cave-Ayland <[email protected]>
It would be good to get this queued to master soon as my local
development setup is currently broken (particularly as I'm working on
series that include documentation changes).
I've now applied this to master as a buildfix; thanks.
Thanks Peter!
ATB,
Mark.
