On Tue, 8 Sept 2026 at 17:34, John Snow <[email protected]> wrote: > > On Sun, Sep 6, 2026 at 6:29 PM Brian Cain <[email protected]> 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. > > Thank you for catching this and writing a very targeted fix. > > I did not notice the silent downgrade as I have sufficiently modern > releases on my base system which our build system happily used > instead, and none of our CI tests noticed. I'll have to invest some > time to ensure this is tested somewhere for the future. > > > > > Signed-off-by: Brian Cain <[email protected]> > > Reviewed-by: John Snow <[email protected]> > > (I did not test this, but based on the failure logs I saw and the PyPI > version constraints for Sphinx, I believe this fix is appropriate. > Peter, would you be so kind as to take this patch directly as a build > fix? I am taking today off as a sick day and don't want a build > failure to linger.)
Sure, I can do that. (Though I haven't seen much complaining, so I expect most people, like you and me and the CI, have the sphinx and rtd-theme installed on the host and dodged the bug :-)) -- PMM
