Changes in test_doc_build.py

f1c2db1f145b5c609ae651d229713e3c7422785a - docs: move test_doc_build.py to tools/docs

Wed, 13 Aug 2025 18:21:50 +0000

docs: move test_doc_build.py to tools/docsAdd this tool to tools/docs.Reviewed-by: Mauro Carvalho Chehab Acked-by: Jani Nikula Signed-off-by: Jonathan Corbet List of files: /linux/tools/docs/test_doc_build.py

bb4c5c50aeeca230428e77f57b60f3a9ef85ca9b - scripts: test_doc_build.py: regroup and rename arguments

Sun, 22 Jun 2025 06:02:41 +0000

scripts: test_doc_build.py: regroup and rename argumentsThe script now have lots or arguments. Better organize andname them, for it to be a little bit more intuitive.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/acf5e1db38ca6a713c44ceca9db5cdd7d3079c92.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

791b9b0333742760107e8719416ced49971ec4dd - scripts: test_doc_build.py: make the script smarter

Sun, 22 Jun 2025 06:02:38 +0000

scripts: test_doc_build.py: make the script smarterMost of the time, testing the full range of supported Sphinxversion is a waste of time and resources. Instead, the best isto focus at the versions that are actually shipped by majordistros.For it to work properly, we need to adjust the requirements forthem to start from first patch for each distro after theminimal supported one. The requirements were re-adjusted toavoid build breakages related to version incompatibilities.Such builds were tested with: ./scripts/test_doc_build.py -m -a "SPHINXOPTS=-j8" "SPHINXDIRS=networking netlink/specs" --fullChange the logic to pick by default only such versions, addinganother parameter to do a comprehensive test.While here, improve the script documentation to make it easierto be used.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/a2b9b7775a185766643ea4b82b558de25b61d6c7.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

0e93f1244db7000ef752e749d202d016663c3f1c - scripts: test_doc_build.py: improve cmd.log logic

Sun, 22 Jun 2025 06:02:37 +0000

scripts: test_doc_build.py: improve cmd.log logicSimplify the logic which handles with new lines.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/2436f37ab7945673f26bcfc94c10e6e76b93c2d8.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

792bf0194ce88606bc08243b78ec2dac2ea10ee5 - scripts: test_doc_build.py: improve dependency list

Sun, 22 Jun 2025 06:02:36 +0000

scripts: test_doc_build.py: improve dependency listChange the dependency list to ensure that:- all docutils versions are covered;- provide an explanation about the dependencies;- set a better minimal requirement for 3.4.3.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/433aeefb4ac9edbd62494334ac07bc1307387d40.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

3fa60d281130064808751f6d48224330f0879ce1 - scripts: test_doc_build.py: better adjust to python version

Sun, 22 Jun 2025 06:02:35 +0000

scripts: test_doc_build.py: better adjust to python versionVery old versions of Sphinx require older versions of python.The original script assumes that a python3.9 exec exists,but this may not be the case.Relax python requirements.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/32cb41c543293bbbab5fcb15f8a0aefac040e3a9.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

fb1e8d1265a555ddd1cbfd0307477b4c4b048cc9 - scripts: test_doc_build.py: better control its output

Sun, 22 Jun 2025 06:02:34 +0000

scripts: test_doc_build.py: better control its outputNow that asyncio is supported, allow userspace to adjustverbosity level and direct the script output to a file.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/76c3a64a87a7493ae607d5c7784b3b829affcaf0.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

7649db7de2932c8e80e4bcf54027b3ad6388d95c - scripts: test_doc_build.py: make capture assynchronous

Sun, 22 Jun 2025 06:02:33 +0000

scripts: test_doc_build.py: make capture assynchronousPrepare the tool to allow writing the output into log files.For such purpose, receive stdin/stdout messages asynchronously.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/9b0a60b5047137b5ba764701268da992767b128c.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py

54c147f4c76c7891afe99ad2bdeba82143fd4ca6 - scripts: scripts/test_doc_build.py: add script to test doc build

Sun, 22 Jun 2025 06:02:32 +0000

scripts: scripts/test_doc_build.py: add script to test doc buildTesting Sphinx backward-compatibility is hard, as per versionminimal Python dependency requirements can be a nightmare.Add a script to help automate such checks.Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Jonathan Corbet Link: https://lore.kernel.org/r/93faf6c35ec865566246ca094868a8e6d85dde39.1750571906.git.mchehab+huawei@kernel.org List of files: /linux/tools/docs/test_doc_build.py