[PATCH 2/4] docs: test_doc_build: update it to support newer Sphinx versions

From: Mauro Carvalho Chehab

Date: Thu Oct 15 2026 - 05:07:10 EST


Current version is 9.1.0. Update the script to handle it. As there
were python deprecations on newer versions, add support for those.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
---
tools/docs/test_doc_build.py | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/tools/docs/test_doc_build.py b/tools/docs/test_doc_build.py
index 4082317d581d..8b57d896c666 100755
--- a/tools/docs/test_doc_build.py
+++ b/tools/docs/test_doc_build.py
@@ -51,6 +51,8 @@ def get_min_python_bin(min_subver):
PYTHON_VER_CHANGES = {
(3, 4, 3): (3, MIN_PYTHON_SUBVER),
(8, 0, 0): (3, 10),
+ (8, 1, 0): (3, 11),
+ (9, 1, 0): (3, 12),
}

DEFAULT_VERSIONS_TO_TEST = [
@@ -61,8 +63,9 @@ DEFAULT_VERSIONS_TO_TEST = [
(7, 2, 6), # Ubuntu 24.04 LTS
(7, 4, 7), # Ubuntu 24.10
(7, 3, 0), # openSUSE Tumbleweed
- (8, 1, 3), # Fedora 42
- (8, 2, 3) # Latest version - covers rolling distros
+ (8, 1, 3), # Debian 13
+ (8, 2, 3), # Ubuntu 26.04 LTS / Fedora 44
+ (9, 1, 0), # Latest version
]

# Sphinx versions to be installed and their incremental requirements
@@ -178,6 +181,10 @@ SPHINX_REQUIREMENTS = {
"PyYAML": "6.0.1",
"sphinxcontrib-serializinghtml": "1.1.9",
},
+ # from https://raw.githubusercontent.com/sphinx-doc/sphinx/v9.0.0/pyproject.toml
+ (9, 0, 0): {
+ "roman-numerals": "1.0.0",
+ },
}


--
2.56.0