fix: Pin Sphinx<9.0.0 for sphinx-tabs compatibility 58/74058/2
authorAnil Belur <abelur@linuxfoundation.org>
Thu, 15 Jan 2026 10:44:55 +0000 (20:44 +1000)
committerAnil Belur <abelur@linuxfoundation.org>
Thu, 15 Jan 2026 10:57:37 +0000 (20:57 +1000)
Sphinx 9.0.0 introduced breaking changes that cause sphinx-tabs
to fail with KeyError: 'backrefs' in tabs.py line 69.

This affects projects like bgpcep where tox docs builds fail:
https://jenkins.opendaylight.org/releng/job/bgpcep-tox-verify-master/1719/console

Root cause: sphinx-tabs has not been updated for Sphinx 9.x yet.
See: https://github.com/executablebooks/sphinx-tabs/issues/206

Pin Sphinx to <9.0.0 until sphinx-tabs releases a compatible version.

Issue-ID: IT-29177
Change-Id: Ic69a55380709003c0a9911c9bf29f374a1d2f0a9
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
requirements.txt

index df60db1..733e25f 100644 (file)
@@ -1,5 +1,5 @@
 PyYAML  # MIT
-Sphinx>=4.2.0  # BSD
+Sphinx>=4.2.0,<9.0.0  # BSD
 sphinx_bootstrap_theme
 sphinx-tabs
 sphinxcontrib-blockdiag  # BSD