Re: [PATCH 1/1] kernel-doc: Support arrays of pointers struct fields

[Jani Nikula <jani.nikula@linux.intel.com>]

On Fri, 14 Feb 2025, Jonathan Corbet <corbet@lwn.net> wrote:
> Mauro Carvalho Chehab <mchehab+huawei@kernel.org> writes:
>
>> Em Tue, 06 Feb 2024 13:20:34 +0200
>> Jani Nikula <jani.nikula@linux.intel.com> escreveu:
>>> - Don't parse the contents of the comments, at all. Treat it as pure
>>>   rst, and let Sphinx handle it.
>
> That would fix the latter problem, at the cost of breaking tens of
> thousands of kerneldoc comments in the code.  I don't relish the idea of
> all the churn needed to fix that up...  That might have been a good
> decision to make 20 years or so ago; it's hard to see it as an option
> now.

Just to be clear, I feel I must repeat the context of my email:

>>> After we'd made kernel-doc the perl script to produce rst, and
>>> kernel-doc the Sphinx extension to consume it, I pondered the same
>>> questions, and wondered what it should all look like if you could just
>>> ignore all the kernel legacy.

There's a huge (olympic pool size) if in there, and that's the main
reason I could create a fun and lean little project around the idea in
the first place!


BR,
Jani.


-- 
Jani Nikula, Intel