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

From: Jonathan Corbet
Date: Thu Mar 18 2021 - 14:18:57 EST


Lukas Bulwahn <lukas.bulwahn@xxxxxxxxx> 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