Subject: Re: linux-next: Tree for December 18 (irq.h documentation)

From: Randy Dunlap <[email-masked]>
Date: Thu, 18 Dec 2008 15:57:09 -0800

Hi YH,

Whenever you update a struct in a header file that uses kernel-doc,
like struct irq_desc in include/linux/irq.h, please also update the
corresponding kernel-doc notation for the new struct members, so
that kernel-doc warnings are not caused:

from linux-next-20081218:

Warning(linux-next-20081218//include/linux/irq.h:192): No description found for parameter 'timer_rand_state'
Warning(linux-next-20081218//include/linux/irq.h:192): No description found for parameter 'kstat_irqs'
Warning(linux-next-20081218//include/linux/irq.h:192): No description found for parameter 'irq_2_iommu'

Please add kernel-doc notation for those missing struct members.

Thanks,
---
~Randy