[RFC] scripts: kernel-doc: avoid warnings due to initial commented lines in file

Jonathan Corbet corbet at lwn.net
Thu Mar 18 18:18:18 UTC 2021


Lukas Bulwahn <lukas.bulwahn at gmail.com> writes:

> Yeah, and as this line-counting is really just a poor man's
> heuristics, we might just be better to really turn this heuristics
> into a dedicated cleanup warning script, then we can check for more
> indicators, such as "does it contain the word Copyright" somewhere in
> the kernel-doc comment, which tells us even more that this is not a
> kernel-doc as we would expect it.

I really don't think we need that kind of heuristic.  The format of
kerneldoc comments is fairly rigid; it shouldn't be too hard to pick out
the /** comments that don't fit that format, right?  Am I missing
something there?

Thanks,

jon


More information about the Linux-kernel-mentees mailing list