Re: [PATCH 00/38] docs: several improvements to kernel-doc
From: Jonathan Corbet <corbet@lwn.net>
Date: 2026-03-04 22:34:11
Also in:
intel-wired-lan, linux-doc, linux-hardening, lkml
From: Jonathan Corbet <corbet@lwn.net>
Date: 2026-03-04 22:34:11
Also in:
intel-wired-lan, linux-doc, linux-hardening, lkml
Jani Nikula [off-list ref] writes:
So yeah, there are definitely tradeoffs there. But it's not like this constant patching of kernel-doc is exactly burden free either. I don't know, is it just me, but I'd like to think as a profession we'd be past writing ad hoc C parsers by now.
I don't think that having a "real" parser is going to free us from the need to patch kernel-doc. The kernel uses a weird form of C, and kernel-doc is expected to evolve as our dialect of the language does. It *might* make that patching job easier -- that is to be seen -- but it won't make it go away. Thanks, jon