Re: [PATCH] docs: xforms_lists: support DEFINE_IDTENTRY_IRQ()

Jonathan Corbet <[email protected]> Mon, 03 Aug 2026 13:03:03 -0600
Newsgroups org.kernel.vger.linux-doc
Message-ID <[email protected]>
Randy Dunlap <[email protected]> writes:

> Avoid kernel-doc warnings by supported DEFINE_IDTENTRY_IRQ() as a
> function transform.
>
> Warning: arch/x86/kernel/apic/apic.c:2157 function parameter
>  'spurious_interrupt' not described in 'DEFINE_IDTENTRY_IRQ'
> Warning: arch/x86/kernel/apic/apic.c:2157 expecting prototype for
>  spurious_interrupt(). Prototype was for DEFINE_IDTENTRY_IRQ() instead
>
> Signed-off-by: Randy Dunlap <[email protected]>
> ---
> Cc: Jonathan Corbet <[email protected]>
> Cc: Shuah Khan <[email protected]>
> Cc: Mauro Carvalho Chehab <[email protected]>
>
>  tools/lib/python/kdoc/xforms_lists.py |    1 +
>  1 file changed, 1 insertion(+)
>
> --- linux-next-20260722.orig/tools/lib/python/kdoc/xforms_lists.py
> +++ linux-next-20260722/tools/lib/python/kdoc/xforms_lists.py
> @@ -90,6 +90,7 @@ class CTransforms:
>          (CMatch("__(?:re)?alloc_size"), ""),
>          (CMatch("__diagnose_as"), ""),
>          (CMatch("DECL_BUCKET_PARAMS"), r"\1, \2"),
> +        (CMatch("DEFINE_IDTENTRY_IRQ"), r"static void \1(struct pt_regs *regs, u32 vector)"),
>          (CMatch("__cond_acquires"), ""),

Applied, thanks.

jon