14835 2022-06-10 16:03:13 +0000 Need autobuilder to build docs with at least Sphinx 4.0 2025-02-20 22:19:33 +0000 1 1 5 Infrastructure AutoBuilder autobuilder unspecified x86 Multiple RESOLVED FIXED Medium+ normal 5.2 M4 1 michael.opdenacker antonin.godard foss+yocto infras.ab.watcher Infras.watcher michael.opdenacker pidge randy.macleod richard.purdie --- --- Yes (doc changes required) oldest_to_newest 93495 0 michael.opdenacker 2022-06-10 16:03:13 +0000 With the latest versions of Sphinx (5.0.1 at the time of this writing), building the docs fails because of this warning (warnings are treated as errors): WARNING: extlinks: Sphinx-6.0 will require a caption string to contain exactly one '%s' and all other '%' need to be escaped as '%%'. To solve this, a solution would be to revert this commit: https://git.yoctoproject.org/yocto-docs/commit/?id=c9922076f5c1285d9cfd6aff8ce5b6635d88222f However, this would be incompatible with the current version of Sphinx used on the autobuilder to build the docs. Here are details from Quentin Schulz: If we revert the patch, we need to use a newer Sphinx for building the docs with the autobuilder (currently 3.2.1) otherwise we get CVE-%s-<CVE_ID> instead of CVE-<CVE_ID>. We'd need a patch that bumps the minimum version of Sphinx to build the docs (in conf.py, needs_sphinx), revert the patch and use a new docs_buildtools in the autobuilder. Without this you're just fixing your a build issue on your local PC and failing the autobuilder. We do not have a "stable" release available yet on https://autobuilder.yocto.io/pub/buildtools/ so we'd need to create one. I know Richard made an attempt a few months ago when we added Sphinx recipe inside poky (specifically for creating the docs buildtools). 93518 1 michael.opdenacker 2022-06-16 14:36:50 +0000 Richard to setup the autobuilder to run tests and figure out which packages we need to achieve this. 93535 2 richard.purdie 2022-06-16 15:44:05 +0000 What needs to happen here is to make a buildtools build with "deploy artefacts" checked. I did this, the result was here: http://autobuilder.yocto.io/pub/non-release/20220616-20/buildtools/ we then add a patch to autobuilder helper to patch the new tarball into run-docs-build, I added one to the master-next branch there. We then trigger a docs build using that branch of autobuilder-helper. I did this here, not sure what broke though: https://autobuilder.yoctoproject.org/typhoon/#/builders/114/builds/478/steps/5/logs/stdio 93539 3 richard.purdie 2022-06-16 16:04:56 +0000 I fixed that issue, now we see other issues that Michael mentioned: https://autobuilder.yoctoproject.org/typhoon/#/builders/114/builds/480/steps/5/logs/stdio Could you push fixes for those onto the yocto-docs master-next branch and then we can merge everything once builds pass? 93541 4 michael.opdenacker 2022-06-16 16:30:15 +0000 Great! Thanks for the progress. I sent a new pull-request for master. Thanks again Michael. 93745 5 richard.purdie 2022-08-10 20:22:08 +0000 Was this completed? 93791 6 foss+yocto 2022-08-12 14:37:21 +0000 (In reply to comment #5) > Was this completed? Technically, yes. But this resulted in other bugs, c.f. https://lists.yoctoproject.org/g/yocto/message/57450 100018 7 randy.macleod 2024-10-24 15:04:01 +0000 Bulk move of 5.1 M4 to 5.2 M2 as approved by AlexB. 101134 8 antonin.godard 2025-02-18 10:08:30 +0000 Hi, We are now using Sphinx on version 8.0.2 to build the master, styhead, and scarthgap branches of the documentation. Out of the maintained branches, only kirkstone is built using Sphinx 5.1.1, but even then, it is newer than the old version mentioned here (3.2.1). Older branches/tags are also built with Sphinx 5.1.1. So if my understanding is correct, this bug can be closed? I don't think there's any of the issues there remaining? Can someone confirm? Antonin 101194 9 richard.purdie 2025-02-20 22:19:33 +0000 I believe this has been addressed and the issue resolved. Thanks!