On Fri, 15 Aug 2025 at 10:51, Mauro Carvalho Chehab <mchehab+hua...@kernel.org> wrote: > > Em Thu, 14 Aug 2025 18:13:17 +0100 > Peter Maydell <peter.mayd...@linaro.org> escreveu: > > > The doc comment for qtest_cb_for_every_machine has a stray > > space at the start of its description, which makes kernel-doc > > think that this line is part of the documentation of the > > skip_old_versioned argument. The result is that the HTML > > doesn't have a "Description" section and the text is instead > > put in the wrong place. > > > > Remove the stray space. > > > > Signed-off-by: Peter Maydell <peter.mayd...@linaro.org> > > LGTM. Even the previous version should have handled it wrong here > (if not, it is a bug there - or perhaps QEMU version was using > a very old kernel-doc.pl version).
Yes, the documentation comes out looking wrong on the old version too -- I only noticed this because I was examining the diffs of the HTML for before and after and the exact way it's rendered changed, so it showed up. Easiest way to reduce the diff was to fix our markup error :-) You can see how the old version outputs it at: https://www.qemu.org/docs/master/devel/testing/qtest.html#c.qtest_cb_for_every_machine -- PMM
