drm/i915: run kernel-doc on headers as part of HDRTEST
authorJani Nikula <jani.nikula@intel.com>
Tue, 4 Apr 2023 09:05:28 +0000 (12:05 +0300)
committerJani Nikula <jani.nikula@intel.com>
Wed, 5 Apr 2023 09:22:24 +0000 (12:22 +0300)
commit899ff790d1a94dda9bd09a4a6bde01fb7ff0bec8
tree880d9df9cbca967ccfcadc1550ea56c7646febdc
parent764b1c8df40daf618b293b367f9be1f4fcd1b6fb
drm/i915: run kernel-doc on headers as part of HDRTEST

Enabling kernel-doc warnings in commit aaee4bbe8a1a ("drm/i915: enable
kernel-doc warnings for CONFIG_DRM_I915_WERROR=y") actually only covers
the .c files. And it's good for avoiding warnings in W= builds. However,
we need something more to check for kernel-doc issues in headers. Add it
as part of the existing HDRTEST.

We have tons of issues, and this unleashes warnings galore on
CONFIG_DRM_I915_WERROR=y. It doesn't fail the build because (at least
for now) we don't pass -Werror to kernel-doc.

Cc: Rodrigo Vivi <rodrigo.vivi@intel.com>
Signed-off-by: Jani Nikula <jani.nikula@intel.com>
Reviewed-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
Acked-by: Nirmoy Das <nirmoy.das@intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20230404090528.173075-1-jani.nikula@intel.com
drivers/gpu/drm/i915/Makefile