kernel-doc: don't let V=1 change outcome
authorJohannes Berg <johannes.berg@intel.com>
Fri, 9 Jun 2023 08:46:41 +0000 (10:46 +0200)
committerMasahiro Yamada <masahiroy@kernel.org>
Sat, 10 Jun 2023 07:39:02 +0000 (16:39 +0900)
commit56b0f453db74207633019f83758b4c11c66b75d0
tree4fcd1efc4a45afdd59aeda5ca3b3fe4afa6ab1cd
parent3a3f1e573a105328a2cca45a7cfbebabbf5e3192
kernel-doc: don't let V=1 change outcome

The kernel-doc script currently reports a number of issues
only in "verbose" mode, but that's initialized from V=1
(via KBUILD_VERBOSE), so if you use KDOC_WERROR=1 then
adding V=1 might actually break the build. This is rather
unexpected.

Change kernel-doc to not change its behaviour wrt. errors
(or warnings) when verbose mode is enabled, but rather add
separate warning flags (and -Wall) for it. Allow enabling
those flags via environment/make variables in the kernel's
build system for easier user use, but to not have to parse
them in the script itself.

Signed-off-by: Johannes Berg <johannes.berg@intel.com>
Acked-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Masahiro Yamada <masahiroy@kernel.org>
Documentation/kbuild/kbuild.rst
scripts/Makefile.build
scripts/kernel-doc