On Mon, 11 May 2026 at 14:19, Jonathan Corbet <[email protected]> wrote: > > Marco Elver <[email protected]> writes: > > > How about the below, i.e. adding type decls that only the kernel-doc > > parser sees? One complication is also DECL_KMALLOC_PARAMS, and adding > > kernel-doc parser hacks for that looks pretty awful, so this is a lot > > cleaner. > > I'm going to be a while catching up with things, so this is just a first > take. I strongly suspect that the people who object so strongly to > documentation markup in general would be less than fully thrilled by the > addition of this kind of workaround. I'd like to ponder a bit and see > if I can some up with something better...but again, it won't happen > right away.
Thanks, Jon. The technical debt (hacks) that would accumulate in the kernel-doc parser just for accommodating slab.h might be quite high; slab.h is rather special, so the "#if 0" solution might be justified. Then again, if there's a reasonable kernel-doc parser solution, that also helps in other places, I won't object. I tested the "#if 0" version and it works as expected. So to move forward, we could consider it in the short term, and in the longer term, see what new powers the kernel-doc parser can provide.
