Re: [PATCH 00/38] docs: several improvements to kernel-doc
From: Jonathan Corbet
Date: Wed Mar 04 2026 - 17:35:55 EST
Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> 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