Re: [PATCH v3] docs: kerneldoc.py: preserve headings in kernel-doc output

From: Karl Mehltretter

Date: Thu Oct 15 2026 - 03:06:10 EST


On Wed, Oct 14, 2026 at 11:46:13PM +0100, Mauro Carvalho Chehab wrote:
> e.g. the ones found on distros up to Fedora 42 and the latest version
> on that time.
>
> to be really sure, use "-f" to test all possible versions.
>
> (*) even with the simplified version checks, ti runs for quite a while:
> some versions take ~20 mins to build docs.
>

Thanks. To be really sure, I am running the full A/B matrix from
tools/docs/test_doc_build.py -f, also newer Sphinx versions and the
Sphinx 9.1.0/Docutils 0.21.2 combination mentioned earlier.

The endpoint tests have passed:

- Sphinx 3.4.3 / Docutils 0.16
- Sphinx 9.1.0 / Docutils 0.22.4

Both builds complete successfully. There are no unexpected diagnostic or
output differences. Changes are limited to the intended heading
restoration and warning removal.

The remaining matrix is running. I will report the full results.

Karl