Intel-XE Archive on lore.kernel.org
 help / color / mirror / Atom feed
From: Michal Wajdeczko <michal.wajdeczko@intel.com>
To: intel-xe@lists.freedesktop.org
Cc: Michal Wajdeczko <michal.wajdeczko@intel.com>
Subject: [PATCH 1/4] drm/xe/guc: Fixup GuC KLV ABI kernel-doc annotations
Date: Tue, 11 Jun 2024 20:07:32 +0200	[thread overview]
Message-ID: <20240611180735.1988-2-michal.wajdeczko@intel.com> (raw)
In-Reply-To: <20240611180735.1988-1-michal.wajdeczko@intel.com>

The kernel-doc for few KLV was malformed:

 guc_klvs_abi.h:70: WARNING: Inline target start-string without end-string.
 guc_klvs_abi.h:74: WARNING: Inline target start-string without end-string.
 guc_klvs_abi.h:78: WARNING: Inline target start-string without end-string.

or it was just unrecognized at all.

Signed-off-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
---
 drivers/gpu/drm/xe/abi/guc_klvs_abi.h | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/drivers/gpu/drm/xe/abi/guc_klvs_abi.h b/drivers/gpu/drm/xe/abi/guc_klvs_abi.h
index 8f9f60b28306..a0b80c9fc5ef 100644
--- a/drivers/gpu/drm/xe/abi/guc_klvs_abi.h
+++ b/drivers/gpu/drm/xe/abi/guc_klvs_abi.h
@@ -66,23 +66,23 @@
  *      Refers to 64 bit Global Gfx address of H2G `CT Buffer`_.
  *      Should be above WOPCM address but below APIC base address for native mode.
  *
- * _`GUC_KLV_SELF_CFG_H2G_CTB_DESCRIPTOR_ADDR : 0x0903
+ * _`GUC_KLV_SELF_CFG_H2G_CTB_DESCRIPTOR_ADDR` : 0x0903
  *      Refers to 64 bit Global Gfx address of H2G `CTB Descriptor`_.
  *      Should be above WOPCM address but below APIC base address for native mode.
  *
- * _`GUC_KLV_SELF_CFG_H2G_CTB_SIZE : 0x0904
+ * _`GUC_KLV_SELF_CFG_H2G_CTB_SIZE` : 0x0904
  *      Refers to size of H2G `CT Buffer`_ in bytes.
  *      Should be a multiple of 4K.
  *
- * _`GUC_KLV_SELF_CFG_G2H_CTB_ADDR : 0x0905
+ * _`GUC_KLV_SELF_CFG_G2H_CTB_ADDR` : 0x0905
  *      Refers to 64 bit Global Gfx address of G2H `CT Buffer`_.
  *      Should be above WOPCM address but below APIC base address for native mode.
  *
- * _GUC_KLV_SELF_CFG_G2H_CTB_DESCRIPTOR_ADDR : 0x0906
+ * _`GUC_KLV_SELF_CFG_G2H_CTB_DESCRIPTOR_ADDR` : 0x0906
  *      Refers to 64 bit Global Gfx address of G2H `CTB Descriptor`_.
  *      Should be above WOPCM address but below APIC base address for native mode.
  *
- * _GUC_KLV_SELF_CFG_G2H_CTB_SIZE : 0x0907
+ * _`GUC_KLV_SELF_CFG_G2H_CTB_SIZE` : 0x0907
  *      Refers to size of G2H `CT Buffer`_ in bytes.
  *      Should be a multiple of 4K.
  */
@@ -114,7 +114,7 @@
 /*
  * Per context scheduling policy update keys.
  */
-enum  {
+enum {
 	GUC_CONTEXT_POLICIES_KLV_ID_EXECUTION_QUANTUM			= 0x2001,
 	GUC_CONTEXT_POLICIES_KLV_ID_PREEMPTION_TIMEOUT			= 0x2002,
 	GUC_CONTEXT_POLICIES_KLV_ID_SCHEDULING_PRIORITY			= 0x2003,
-- 
2.43.0


  reply	other threads:[~2024-06-11 18:07 UTC|newest]

Thread overview: 16+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-06-11 18:07 [PATCH 0/4] More GuC ABI fixes Michal Wajdeczko
2024-06-11 18:07 ` Michal Wajdeczko [this message]
2024-06-11 18:07 ` [PATCH 2/4] drm/xe/guc: Update GuC CTB Descriptor ABI Michal Wajdeczko
2024-06-11 18:07 ` [PATCH 3/4] drm/xe/guc: Fixup HXG Fast Request description Michal Wajdeczko
2024-06-11 18:07 ` [PATCH 4/4] drm/xe/guc: Avoid named enum types in GuC KLV ABI Michal Wajdeczko
2024-06-11 20:16   ` John Harrison
2024-06-11 21:14     ` Michal Wajdeczko
2024-06-12 20:50       ` John Harrison
2024-06-11 20:25 ` ✓ CI.Patch_applied: success for More GuC ABI fixes Patchwork
2024-06-11 20:26 ` ✗ CI.checkpatch: warning " Patchwork
2024-06-11 20:27 ` ✓ CI.KUnit: success " Patchwork
2024-06-11 20:38 ` ✓ CI.Build: " Patchwork
2024-06-11 20:41 ` ✗ CI.Hooks: failure " Patchwork
2024-06-11 20:42 ` ✓ CI.checksparse: success " Patchwork
2024-06-11 21:24 ` ✓ CI.BAT: " Patchwork
2024-06-12  2:27 ` ✗ CI.FULL: failure " Patchwork

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=20240611180735.1988-2-michal.wajdeczko@intel.com \
    --to=michal.wajdeczko@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