linux-kernel - Re: [REGRESSION] Unexpected section title false positive warnings on DOC: directive

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <87ikdecsj0.fsf@trenco.lwn.net>
Date: Tue, 06 Jan 2026 14:58:43 -0700
From: Jonathan Corbet <corbet@....net>
To: Bagas Sanjaya <bagasdotme@...il.com>, Linux Kernel Mailing List
 <linux-kernel@...r.kernel.org>, Linux Documentation
 <linux-doc@...r.kernel.org>, Linux Regressions
 <regressions@...ts.linux.dev>
Cc: Mauro Carvalho Chehab <mchehab+huawei@...nel.org>, Randy Dunlap
 <rdunlap@...radead.org>
Subject: Re: [REGRESSION] Unexpected section title false positive warnings
 on DOC: directive

Bagas Sanjaya <bagasdotme@...il.com> writes:

> Hi,
>
> Building htmldocs on docs-next currenly produces about 50 new warnings; which
> all of them are unexpected section title on DOC: kernel-doc directive, like:
>
> /home/bagas/repo/linux-kernel/Documentation/driver-api/target:25: ./drivers/target/target_core_user.c:35: CRITICAL: Unexpected section title.
>
> Userspace I/O
> ------------- [docutils]
> WARNING: kernel-doc 'scripts/kernel-doc.py -rst -enable-lineno -function 'Userspace I/O' ./drivers/target/target_core_user.c' processing failed with: SystemMessage('/home/bagas/repo/linux-kernel/Documentation/driver-api/target:25: ./drivers/target/target_core_user.c:35: (SEVERE/4) Unexpected section title.\n\nUserspace I/O\n-------------')
> /home/bagas/repo/linux-kernel/Documentation/driver-api/target:28: ./include/uapi/linux/target_core_user.h:14: CRITICAL: Unexpected section title.

So I did not, and do not, see any of these errors; are you doing
something special to get them?

jon