On Wed, 30 Apr 2025 at 10:14, Dario Faggioli <dfaggi...@suse.com> wrote: > > Hello, > > When building both v10.0.0 and master sequentially (like -j1 or > equivalent, e.g., when in a 1 vCPU VM) it fails when we get to docs > (`make man` is also enough to reproduce it), with this error: > > [1/2] /usr/bin/env CONFDIR=/etc/qemu > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/pyvenv/bin/sphinx-build > -q -W -Dkerneldoc_werror=1 -j 1 -Dversion=10.0.50 > '-Drelease=Virtualization:Staging:10.0 / openSUSE_Tumbleweed' > -Ddepfile=docs/docs.d -Ddepfile_stamp=docs/docs.stamp -b html -d > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/docs/manual.p > /home/dario/Sources/qemu/suse/git_upstreams/qemu/docs > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/docs/manual > FAILED: docs/docs.stamp > /usr/bin/env CONFDIR=/etc/qemu > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/pyvenv/bin/sphinx-build > -q -W -Dkerneldoc_werror=1 -j 1 -Dversion=10.0.50 > '-Drelease=Virtualization:Staging:10.0 / openSUSE_Tumbleweed' > -Ddepfile=docs/docs.d -Ddepfile_stamp=docs/docs.stamp -b html -d > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/docs/manual.p > /home/dario/Sources/qemu/suse/git_upstreams/qemu/docs > /home/dario/Sources/qemu/suse/git_upstreams/qemu/build/docs/manual > > /home/dario/Sources/qemu/suse/git_upstreams/qemu/docs/system/qemu-block-drivers.rst.inc:506: > WARNING: duplicate label nbd, other instance in > /home/dario/Sources/qemu/suse/git_upstreams/qemu/docs/system/images.rst > ninja: build stopped: subcommand failed. > make[1]: *** [Makefile:168: run-ninja] Error 1 > make[1]: Leaving directory > '/home/dario/Sources/qemu/suse/git_upstreams/qemu/build' > make: *** [GNUmakefile:6: build] Error 2 > > It works, instead, in parallel builds. In fact, building with 2 > processes seems to be already enough for compiling the docs > successfully. > > OTOH, v9.2.3 works for me, in both sequential and parallel builds. > > I've tried to remove the `-W -Dkerneldoc_werror=1` arguments from > sphinx-build and that "resolves" the issue, so I think the problem is > the "WARNING: duplicate label nbd".
It's odd that it only fails in -j1 -- our current thought was that this was related to the Sphinx version (some versions warn, some do not). I sent this patchset yesterday which I think should fix it: https://patchew.org/QEMU/20250429163212.618953-1-peter.mayd...@linaro.org/ You might also be able to avoid the failure if you configure with --disable-werror : I think (but have not tested) that that should make the warnings non-fatal for Sphinx as well as the C compiler. thanks -- PMM
