linux/tools/lib
Omokefe Emmanuel Onanaroghene 2d72a4c098 docs: kdoc: parse context_lock_struct() as struct declaration
kernel-doc fails to parse struct declarations wrapped in
context_lock_struct(), e.g. struct debugfs_cancellation:

  include/linux/debugfs.h:245 ... error: Cannot parse struct or union!

Add a struct transform that expands context_lock_struct() to a plain
struct declaration, and apply the struct transforms to the whole
declaration before split_struct_proto(), matching what dump_var() and
dump_function() already do for their prototypes. The member-only
transform in dump_struct() is then redundant.

Add a regression test for the debugfs_cancellation declaration.

Fixes: 6e530e2e31 ("debugfs: Make debugfs_cancellation a context lock struct")
Signed-off-by: Omokefe Emmanuel Onanaroghene <emmaonana18@gmail.com>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Aleksandr Loktionov <aleksandr.loktionov@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260925234054.128477-1-emmaonana18@gmail.com>
2026-09-29 16:59:29 -06:00
..
api tools/build: selftests: Remove some duplicate toolchain definitions 2026-07-25 22:25:00 -07:00
bpf perf tools updates for v7.3 2026-08-22 08:47:50 -07:00
perf libperf: Document code simplification case for widening struct perf_cpu 2026-06-10 15:23:54 -03:00
python docs: kdoc: parse context_lock_struct() as struct declaration 2026-09-29 16:59:29 -06:00
subcmd tools/build: selftests: Remove some duplicate toolchain definitions 2026-07-25 22:25:00 -07:00
symbol tools/build: selftests: Remove some duplicate toolchain definitions 2026-07-25 22:25:00 -07:00
thermal tools/lib/thermal: Fix misplaced extern "C" closing brace 2026-08-07 17:18:51 +02:00
argv_split.c
bitmap.c mm/vma: add vma_flags_empty(), vma_flags_and(), vma_flags_diff_pair() 2026-04-05 13:53:38 -07:00
cmdline.c memblock test: fix implicit declaration of function 'memparse' 2024-08-06 08:21:25 +03:00
ctype.c
find_bit.c
hweight.c
list_sort.c tools/lib/list_sort: remove unnecessary header includes 2024-11-05 17:12:33 -08:00
rbtree.c tools lib rbtree: pick some improvements from the kernel rbtree code 2024-05-08 08:41:27 -07:00
slab.c lib/rbtree: enable userland test suite for rbtree related data structure 2025-03-17 12:17:00 -07:00
str_error_r.c
string.c perf annotate: Add disasm_line__parse() to parse raw instruction for powerpc 2024-07-31 16:12:59 -03:00
vsprintf.c
zalloc.c