[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