summaryrefslogtreecommitdiff
path: root/tools/lib/python
diff options
context:
space:
mode:
authorPasha Tatashin <pasha.tatashin@soleen.com>2026-10-14 22:03:13 -0400
committerJonathan Corbet <corbet@lwn.net>2026-10-22 09:45:11 -0600
commit4180abdb5d9386188fab56709773208075fadd81 (patch)
tree39bafd1f75e290ba15addece18856251840ad25f /tools/lib/python
parentef6ef17ec4707d3814e22b8ad71e33e725b0a61f (diff)
downloadlinux-4180abdb5d9386188fab56709773208075fadd81.tar.gz
linux-4180abdb5d9386188fab56709773208075fadd81.zip
docs: xforms_lists: Handle DECLARE_KHOSER_PTR() struct members
KHO ABI structures declare their preservation pointers with DECLARE_KHOSER_PTR(name, type), which expands to a union of the pointer and its physical address. kernel-doc does not know the macro and does not see the member: it warns that an unnamed member is not described and that the description of the member is excess. Translate DECLARE_KHOSER_PTR(name, type) into "type name", as is done for DECLARE_KFIFO_PTR(). Signed-off-by: Pasha Tatashin <pasha.tatashin@soleen.com> Message-ID: <20261015020313.946940-1-pasha.tatashin@soleen.com> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'tools/lib/python')
-rw-r--r--tools/lib/python/kdoc/xforms_lists.py1
1 files changed, 1 insertions, 0 deletions
diff --git a/tools/lib/python/kdoc/xforms_lists.py b/tools/lib/python/kdoc/xforms_lists.py
index 15f6f21c7a9e..161acac90ea3 100644
--- a/tools/lib/python/kdoc/xforms_lists.py
+++ b/tools/lib/python/kdoc/xforms_lists.py
@@ -45,6 +45,7 @@ class CTransforms:
(CMatch("DECLARE_HASHTABLE"), r"unsigned long \1[1 << ((\2) - 1)]"),
(CMatch("DECLARE_KFIFO"), r"\2 *\1"),
(CMatch("DECLARE_KFIFO_PTR"), r"\2 *\1"),
+ (CMatch("DECLARE_KHOSER_PTR"), r"\2 \1"),
(CMatch("(?:__)?DECLARE_FLEX_ARRAY"), r"\1 \2[]"),
(CMatch("DEFINE_DMA_UNMAP_ADDR"), r"dma_addr_t \1"),
(CMatch("DEFINE_DMA_UNMAP_LEN"), r"__u32 \1"),