From mboxrd@z Thu Jan 1 00:00:00 1970 From: Randy Dunlap Subject: Re: linux-next: Tree for December 18 (irq.h documentation) Date: Thu, 18 Dec 2008 16:45:16 -0800 Message-ID: <494AEE9C.1010200@oracle.com> References: <20081218230637.c879a046.sfr@canb.auug.org.au> <20081218155709.bf435d8c.randy.dunlap@oracle.com> <494AEBCA.70108@kernel.org> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Return-path: Received: from acsinet11.oracle.com ([141.146.126.233]:42926 "EHLO acsinet11.oracle.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751411AbYLSApk (ORCPT ); Thu, 18 Dec 2008 19:45:40 -0500 In-Reply-To: <494AEBCA.70108@kernel.org> Sender: linux-next-owner@vger.kernel.org List-ID: To: Yinghai Lu Cc: Ingo Molnar , Stephen Rothwell , linux-next@vger.kernel.org, LKML Yinghai Lu wrote: > 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 Thanks. Please see below. > [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 Format is: * @member: description I.e., please add a ':' after each member name. > * @handle_irq: highlevel irq-events handler [if NULL, __do_IRQ()] > * @chip: low level interrupt hardware access > * @msi_desc: MSI descriptor -- ~Randy