diff options
| author |  Johannes Berg <johannes.berg@intel.com>
| 2023-06-09 10:46:41 +0200 |
|---|---|---|
| committer |  Masahiro Yamada <masahiroy@kernel.org>
| 2023-06-10 16:39:02 +0900 |
| commit | 56b0f453db74207633019f83758b4c11c66b75d0 (patch) | |
| tree | 4fcd1efc4a45afdd59aeda5ca3b3fe4afa6ab1cd /Documentation/kbuild | |
| parent | modpost: fix off by one in is_executable_section() (diff) | |
| download | linux-56b0f453db74207633019f83758b4c11c66b75d0.tar.gz linux-56b0f453db74207633019f83758b4c11c66b75d0.tar.bz2 linux-56b0f453db74207633019f83758b4c11c66b75d0.zip | |
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>
Diffstat (limited to 'Documentation/kbuild')
| -rw-r--r-- | Documentation/kbuild/kbuild.rst | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/kbuild/kbuild.rst b/Documentation/kbuild/kbuild.rst index 2a22ddb1b848..bd906407e307 100644 --- a/Documentation/kbuild/kbuild.rst +++ b/Documentation/kbuild/kbuild.rst @@ -150,6 +150,12 @@ the UTS_MACHINE variable, and on some architectures also the kernel config. The value of KBUILD_DEBARCH is assumed (not checked) to be a valid Debian architecture. +KDOCFLAGS +--------- +Specify extra (warning/error) flags for kernel-doc checks during the build, +see scripts/kernel-doc for which flags are supported. Note that this doesn't +(currently) apply to documentation builds. + ARCH ---- Set ARCH to the architecture to be built. |