Re: [PATCH] docs: kdoc: parse context_lock_struct() as struct declaration

[Bart Van Assche]

On 9/25/26 4:40 PM, Omokefe Emmanuel Onanaroghene wrote:
> kernel-doc fails to parse struct declarations wrapped in
> context_lock_struct(), e.g. struct debugfs_cancellation:

Has this alternative been considered: instead of modifying
tools/lib/python/kdoc/kdoc_parser.py, apply the following change:

diff --git a/include/linux/debugfs.h b/include/linux/debugfs.h
index 4177c4738282..aa591f0b0920 100644
--- a/include/linux/debugfs.h
+++ b/include/linux/debugfs.h
@@ -233,13 +233,14 @@ ssize_t debugfs_write_file_bool(struct file *file, 
const char __user *user_buf,
 ssize_t debugfs_read_file_str(struct file *file, char __user *user_buf,
 			      size_t count, loff_t *ppos);

+context_lock_struct(debugfs_cancellation);
 /**
  * struct debugfs_cancellation - cancellation data
  * @list: internal, for keeping track
  * @cancel: callback to call
  * @cancel_data: extra data for the callback to call
  */
-context_lock_struct(debugfs_cancellation) {
+struct debugfs_cancellation {
 	struct list_head list;
 	void (*cancel)(struct dentry *, void *);
 	void *cancel_data;

Thanks,

Bart.