scripts: test_doc_build.py: make the script smarter
authorMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Sun, 22 Jun 2025 06:02:38 +0000 (08:02 +0200)
committerJonathan Corbet <corbet@lwn.net>
Wed, 25 Jun 2025 18:22:48 +0000 (12:22 -0600)
commit791b9b0333742760107e8719416ced49971ec4dd
tree8c02cece78dc3f37a21d0565ff00623ac9d3e645
parent0e93f1244db7000ef752e749d202d016663c3f1c
scripts: test_doc_build.py: make the script smarter

Most of the time, testing the full range of supported Sphinx
version is a waste of time and resources. Instead, the best is
to focus at the versions that are actually shipped by major
distros.

For it to work properly, we need to adjust the requirements for
them to start from first patch for each distro after the
minimal supported one. The requirements were re-adjusted to
avoid build breakages related to version incompatibilities.
Such builds were tested with:

./scripts/test_doc_build.py -m -a "SPHINXOPTS=-j8" "SPHINXDIRS=networking netlink/specs" --full

Change the logic to pick by default only such versions, adding
another parameter to do a comprehensive test.

While here, improve the script documentation to make it easier
to be used.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/a2b9b7775a185766643ea4b82b558de25b61d6c7.1750571906.git.mchehab+huawei@kernel.org
scripts/test_doc_build.py