From mboxrd@z Thu Jan 1 00:00:00 1970 From: Yinghai Lu Subject: Re: linux-next: Tree for December 18 (irq.h documentation) Date: Thu, 18 Dec 2008 16:33:14 -0800 Message-ID: <494AEBCA.70108@kernel.org> References: <20081218230637.c879a046.sfr@canb.auug.org.au> <20081218155709.bf435d8c.randy.dunlap@oracle.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Return-path: Received: from hera.kernel.org ([140.211.167.34]:35387 "EHLO hera.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752375AbYLSAeB (ORCPT ); Thu, 18 Dec 2008 19:34:01 -0500 In-Reply-To: <20081218155709.bf435d8c.randy.dunlap@oracle.com> Sender: linux-next-owner@vger.kernel.org List-ID: To: Randy Dunlap , Ingo Molnar Cc: Stephen Rothwell , linux-next@vger.kernel.org, LKML Randy Dunlap wrote: > 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 check [PATCH] sparseirq: add kernel-doc notation for new member in irq_desc Signed-off-by: Yinghai Lu diff --git a/include/linux/irq.h b/include/linux/irq.h index 1beb63a..4675682 100644 --- a/include/linux/irq.h +++ b/include/linux/irq.h @@ -135,6 +135,9 @@ struct irq_2_iommu; /** * struct irq_desc - interrupt descriptor * @irq: interrupt number for this descriptor + * @timer_rand_state pointer to timer rand state struct + * @kstat_irqs irq stats per cpu + * @irq_2_iommu iommu with this irq * @handle_irq: highlevel irq-events handler [if NULL, __do_IRQ()] * @chip: low level interrupt hardware access * @msi_desc: MSI descriptor