Jani Nikula <jani.nikula@xxxxxxxxxxxxxxx> writes: > 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! Yup, sorry if I trimmed that out. I just wanted to be clear as well... I've often thought that life would be a lot easier if we could stop trying to maintain our own C parser (and maybe Rust too someday?), but I don't really see a path toward that. Thanks, jon
