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).


ATB,

Mark.


Reply via email to