Add optional check for bad kernel-doc comments
authorMatthew Wilcox <willy@infradead.org>
Mon, 20 Nov 2017 18:40:40 +0000 (10:40 -0800)
committerJonathan Corbet <corbet@lwn.net>
Mon, 20 Nov 2017 19:09:11 +0000 (12:09 -0700)
commit3a025e1d1c2ea42fa497c9c6b21c284e0f69e28b
tree82ed4e7dfbd05c14aa0e108e0c3d173504903c86
parente7e61fc0ba7b92153e17f1f707d2b7b3d52c0588
Add optional check for bad kernel-doc comments

Implement a '-none' output mode for kernel-doc which will only output
warning messages, and suppresses the warning message about there being
no kernel-doc in the file.

If the build has requested additional warnings, automatically check all
.c files.  This patch does not check .h files.  Enabling the warning
by default would add about 1300 warnings, so it's default off for now.
People who care can use this to check they didn't break the docs and
maybe we'll get all the warnings fixed and be able to enable this check
by default in the future.

Signed-off-by: Matthew Wilcox <mawilcox@microsoft.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/Makefile.build
scripts/kernel-doc