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

[Mauro Carvalho Chehab <mchehab+huawei@kernel.org>]

On Fri, 16 Oct 2026 08:25:23 -0600
Jonathan Corbet <corbet@lwn.net> wrote:

> Karl Mehltretter <kmehltretter@gmail.com> writes:
> 
> > On Wed, Oct 14, 2026 at 11:46:13PM +0100, Mauro Carvalho Chehab wrote:  
> >> On Wed, 14 Oct 2026 11:08:39 -0600
> >> Jonathan Corbet <corbet@lwn.net> wrote:
> >>   
> >> > Which versions of Sphinx and docutils have you tested this with?  I
> >> > needs to work across the full range of supported versions...  
> >> 
> >> The minimal docutils supported is 0.16, and the minimal Sphinx
> >> supported version is 3.4.4.
> >> 
> >> You can use /tools/docs/test_doc_build.py to double check if your change
> >> is compatible with the minimal supported Sphinx/docutils versions.
> >>   
> >
> > I completed the A/B matrix using tools/docs/test_doc_build.py -f. The
> > full matrix shows the improvement without a regression. 
> >
> > I also tested Sphinx 9.0.0, 9.0.4, and 9.1.0, plus the previously
> > discussed Sphinx 9.1.0 / Docutils 0.21.2 pair.
> >
> > In total, this covered 32 combinations and 64 full htmldocs builds: A
> > unpatched and B patched.
> >
> > Successful, with identical A/B output and normalized diagnostics (26):
> >
> >   Docutils  Sphinx
> >   --------  --------------------------------------------------------
> >   0.16      3.4.3, 3.5.0, 4.0.0
> >   0.17      4.1.0, 4.3.0, 4.4.0
> >   0.17.1    4.5.0, 5.0.0, 5.1.0
> >   0.18      5.2.0
> >   0.18.1    5.3.0, 6.0.0, 6.1.0, 6.1.1, 6.2.0, 7.0.0, 7.1.0
> >   0.20      7.2.6, 7.3.0
> >   0.20.1    7.4.0, 7.4.7
> >   0.21      8.0.0
> >   0.21.1    8.1.0, 8.1.3
> >   0.21.2    8.2.0, 9.1.0  
> 
> That seems exhaustive, thanks :)
> 
> I have buttoned things up for the first 7.4 pull, but will consider this
> for later in the merge window.

Heh, likely took hours, as version 6.x and 7.x are really time consuming
;-)

Thanks for doing that.

Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>


Thanks,
Mauro