linux/drivers/gpu/drm/xe/abi
Chaitanya Kumar Borah 6282995188
drm/xe/guc: Fix kernel-doc warning in GuC scheduler ABI header
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

v2:
 - Add Fixes tag (Daniele)

Fixes: b0c5cf4f59 ("drm/gt/guc: extract scheduler-related defines from guc_fwif.h")
Signed-off-by: Chaitanya Kumar Borah <chaitanya.kumar.borah@intel.com>
Reviewed-by: Shuicheng Lin <shuicheng.lin@intel.com>
Reviewed-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>
Signed-off-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>
Link: https://patch.msgid.link/20260130135210.2659200-1-chaitanya.kumar.borah@intel.com
(cherry picked from commit f89dbe14a0)
Signed-off-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
2026-02-05 08:03:30 -05:00
..
gsc_command_header_abi.h
gsc_mkhi_commands_abi.h
gsc_proxy_commands_abi.h drm/xe/gsc: Initialize GSC proxy 2024-01-18 11:04:34 -08:00
gsc_pxp_commands_abi.h drm/xe/pxp: Add GSC session initialization support 2025-02-03 11:51:15 -08:00
guc_actions_abi.h drm/xe/guc: Add page reclamation interface to GuC 2025-12-12 16:59:09 -08:00
guc_actions_slpc_abi.h drm/xe/guc: Add SLPC power profile interface 2025-09-11 08:45:05 -04:00
guc_actions_sriov_abi.h drm/xe/vf: Introduce RESFIX start marker support 2025-12-02 16:15:55 +01:00
guc_capture_abi.h drm/xe: Fix all typos in xe 2025-01-09 17:58:09 +01:00
guc_communication_ctb_abi.h drm/xe/guc: Dead CT helper 2024-10-07 18:34:59 -07:00
guc_communication_mmio_abi.h
guc_errors_abi.h drm/xe/guc: Add more GuC load error status codes 2025-07-28 14:38:44 -07:00
guc_klvs_abi.h drm/xe/pf: Add functions to set preempt timeouts for each group 2025-12-22 10:22:16 -08:00
guc_lfd_abi.h drm/xe/guc: fix struct guc_lfd_file_header kernel-doc 2026-01-09 16:42:38 +02:00
guc_lic_abi.h drm/xe/guc: Add log init config abi definitions 2025-12-04 13:43:25 -08:00
guc_log_abi.h drm/xe/guc: Cleanup GuC log buffer macros and helpers 2025-11-24 10:50:07 -08:00
guc_messages_abi.h drm/xe/guc: Add kernel-doc for HXG Fast Request 2024-06-11 12:25:21 +02:00
guc_relay_actions_abi.h drm/xe/guc: Add GuC Relay ABI version 1.0 definitions 2024-04-24 15:10:39 +02:00
guc_relay_communication_abi.h drm/xe/guc: Add Relay Communication ABI definitions 2024-01-05 16:25:53 +01:00
guc_scheduler_abi.h drm/xe/guc: Fix kernel-doc warning in GuC scheduler ABI header 2026-02-05 08:03:30 -05:00