Re: [PATCH] drm/xe/guc: Fix kernel-doc warning in GuC scheduler ABI header

[Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>]

On 1/29/2026 2:37 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

Given that this is a build fix, I think this patch needs a fixes tag:

Fixes: b0c5cf4f5917 ("drm/gt/guc: extract scheduler-related defines from 
guc_fwif.h")

With that:

Reviewed-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>

Daniele

> Signed-off-by: Chaitanya Kumar Borah <chaitanya.kumar.borah@intel.com>
> ---
>   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)