On Fri, 14 Feb 2025, Jonathan Corbet <corbet@xxxxxxx> wrote: > Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> writes: > >> Em Tue, 06 Feb 2024 13:20:34 +0200 >> Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> 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
