On Thu, Jan 29, 2026 2:38 AM Chaitanya Kumar Borah wrote: > The GuC scheduler ABI header contains a file-level comment that is not > intended to document a kernel-doc symbol. Using kernel-doc comment syntax > (/** */) triggers kernel-doc warnings. > > With "-Werror", this causes the build to fail. Convert the comment to a > regular > block comment. > > HDRTEST drivers/gpu/drm/xe/abi/guc_scheduler_abi.h > Warning: drivers/gpu/drm/xe/abi/guc_scheduler_abi.h:11 This comment > starts with '/**', but isn't a kernel-doc comment. Refer to Documentation/doc- > guide/kernel-doc.rst > * Generic defines required for registration with and submissions to the GuC > 1 warnings as errors > make[6]: *** [drivers/gpu/drm/xe/Makefile:377: > drivers/gpu/drm/xe/abi/guc_scheduler_abi.hdrtest] Error 3 > make[5]: *** [scripts/Makefile.build:544: drivers/gpu/drm/xe] Error 2 > make[4]: *** [scripts/Makefile.build:544: drivers/gpu/drm] Error 2 > make[3]: *** [scripts/Makefile.build:544: drivers/gpu] Error 2 > make[2]: *** [scripts/Makefile.build:544: drivers] Error 2 > make[1]: *** [/home/kbuild2/kernel/Makefile:2088: .] Error 2 > make: *** [Makefile:248: __sub-make] Error 2 > > Signed-off-by: Chaitanya Kumar Borah <[email protected]>
LGTM. Reviewed-by: Shuicheng Lin <[email protected]> > --- > drivers/gpu/drm/xe/abi/guc_scheduler_abi.h | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/gpu/drm/xe/abi/guc_scheduler_abi.h > b/drivers/gpu/drm/xe/abi/guc_scheduler_abi.h > index 513b22a87428..19ec89bf39c5 100644 > --- a/drivers/gpu/drm/xe/abi/guc_scheduler_abi.h > +++ b/drivers/gpu/drm/xe/abi/guc_scheduler_abi.h > @@ -8,7 +8,7 @@ > > #include <linux/types.h> > > -/** > +/* > * Generic defines required for registration with and submissions to the GuC > * scheduler. Includes engine class/instance defines and context attributes > * (id, priority, etc) > -- > 2.25.1
