From: Shuicheng Lin <shuicheng.lin@intel.com>
To: intel-xe@lists.freedesktop.org
Cc: Shuicheng Lin <shuicheng.lin@intel.com>,
Brian Nguyen <brian3.nguyen@intel.com>
Subject: [PATCH v3 2/4] drm/xe: Add missing '@' prefix to kernel-doc member tags
Date: Tue, 14 Apr 2026 22:54:31 +0000 [thread overview]
Message-ID: <20260414225457.3687449-3-shuicheng.lin@intel.com> (raw)
In-Reply-To: <20260414225457.3687449-1-shuicheng.lin@intel.com>
Add the required '@' prefix to member documentation tags that were
missing it. Without the prefix, kernel-doc does not associate the
comment with the struct member.
- xe_guc_ct_types.h: snapshot_ct -> @snapshot_ct,
snapshot_log -> @snapshot_log
- xe_pagefault_types.h: consumer.reserved -> @consumer.reserved
- xe_pt_types.h: addr -> @addr
Assisted-by: GitHub Copilot:claude-sonnet-4.6
Reviewed-by: Brian Nguyen <brian3.nguyen@intel.com>
Signed-off-by: Shuicheng Lin <shuicheng.lin@intel.com>
---
drivers/gpu/drm/xe/xe_guc_ct_types.h | 4 ++--
drivers/gpu/drm/xe/xe_pagefault_types.h | 2 +-
drivers/gpu/drm/xe/xe_pt_types.h | 2 +-
3 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/drivers/gpu/drm/xe/xe_guc_ct_types.h b/drivers/gpu/drm/xe/xe_guc_ct_types.h
index c81996f8915a..f88e588af0d3 100644
--- a/drivers/gpu/drm/xe/xe_guc_ct_types.h
+++ b/drivers/gpu/drm/xe/xe_guc_ct_types.h
@@ -102,9 +102,9 @@ struct xe_dead_ct {
bool reported;
/** @worker: worker thread to get out of interrupt context before dumping */
struct work_struct worker;
- /** snapshot_ct: copy of CT state and CTB content at point of error */
+ /** @snapshot_ct: copy of CT state and CTB content at point of error */
struct xe_guc_ct_snapshot *snapshot_ct;
- /** snapshot_log: copy of GuC log at point of error */
+ /** @snapshot_log: copy of GuC log at point of error */
struct xe_guc_log_snapshot *snapshot_log;
};
diff --git a/drivers/gpu/drm/xe/xe_pagefault_types.h b/drivers/gpu/drm/xe/xe_pagefault_types.h
index b3289219b1be..aa3cfae01b9c 100644
--- a/drivers/gpu/drm/xe/xe_pagefault_types.h
+++ b/drivers/gpu/drm/xe/xe_pagefault_types.h
@@ -86,7 +86,7 @@ struct xe_pagefault {
u8 engine_class;
/** @consumer.engine_instance: engine instance */
u8 engine_instance;
- /** consumer.reserved: reserved bits for future expansion */
+ /** @consumer.reserved: reserved bits for future expansion */
u64 reserved;
} consumer;
/**
diff --git a/drivers/gpu/drm/xe/xe_pt_types.h b/drivers/gpu/drm/xe/xe_pt_types.h
index 84b51d3762a4..a7d1bb708b69 100644
--- a/drivers/gpu/drm/xe/xe_pt_types.h
+++ b/drivers/gpu/drm/xe/xe_pt_types.h
@@ -34,7 +34,7 @@ struct xe_pt {
bool rebind;
bool is_compact;
#if IS_ENABLED(CONFIG_DRM_XE_DEBUG_VM)
- /** addr: Virtual address start address of the PT. */
+ /** @addr: Virtual address start address of the PT. */
u64 addr;
#endif
};
--
2.43.0
next prev parent reply other threads:[~2026-04-14 22:59 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-04-14 22:54 [PATCH v3 0/4] kernel-doc fix for headers Shuicheng Lin
2026-04-14 22:54 ` [PATCH v3 1/4] drm/xe: Fix stale and mismatched kernel-doc member tags in header files Shuicheng Lin
2026-04-14 22:54 ` Shuicheng Lin [this message]
2026-04-14 22:54 ` [PATCH v3 3/4] drm/xe: Fix kernel-doc comment syntax issues " Shuicheng Lin
2026-04-14 22:54 ` [PATCH v3 4/4] drm/xe: Fix type and parameter name mismatches in kernel-doc references Shuicheng Lin
2026-04-15 0:06 ` ✗ CI.checkpatch: warning for kernel-doc fix for headers (rev3) Patchwork
2026-04-15 0:08 ` ✓ CI.KUnit: success " Patchwork
2026-04-15 1:09 ` ✓ Xe.CI.BAT: " Patchwork
2026-04-15 2:05 ` ✗ Xe.CI.FULL: failure " Patchwork
2026-04-16 15:41 ` Lin, Shuicheng
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260414225457.3687449-3-shuicheng.lin@intel.com \
--to=shuicheng.lin@intel.com \
--cc=brian3.nguyen@intel.com \
--cc=intel-xe@lists.freedesktop.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox