Re: [Ksummit-discuss] coverity, static checking etc.

[Mauro Carvalho Chehab <m.chehab@samsung.com>]

Em Mon, 12 May 2014 08:48:11 +0200
Michal Simek <monstr@monstr.eu> escreveu:

> The part of this discussion
> should be also kernel-doc format checking because a lot of patches
> are trying to use kernel-doc format but it is just broken - even checker
> is in the kernel.

There are several drivers still using other styles for documenting functions.

I can be partially blamed for accepting such patches, but, I don't feel
it is fair to refuse merging a patchset just because they're following some
other documentation style. We have some really big drivers at media
ported from another OS using Doxygen style. Fixing them would likely
require hundreds of hours that could otherwise be used implementing
new stuff or fixing real bugs.

So, I would rather prefer to have a (semi-)automated tool capable of
converting from Doxygen and other styles into kernel-doc style that
would make such conversion an easy task.

Regards,
Mauro