From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 78687C25B76 for ; Wed, 5 Jun 2024 20:03:01 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:Date:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=mv3O3/jZom28u7jJgK29dBVcLNM8wQdnJWGlH0/SqKk=; b=HPxFol0q1w0GOS 3IQOtUWc7y8zhfaPYhPrhp5PWhxbCSJhFBErqL1xcJ9gA3jgmETz5N0lUc9jqz53VUqwkVQ54BJ/o af1+UI021YsiZNRgPimaSUhvcyMLC7b76cMjFb15aNNHH//4CyEzcQcnm5WMM/xP8Ks0wNE6LH7SL Huynom0SBwCoWcDQIHMN/Z9+J6S557IgCsprzgWuTrxHqmV/uJ/5OLr/TdGSp9hPMOoB5/63QwCJM Bfn9HACSnI9Rk1Iv16o9vVxIMrrgj3wxnkKfhyVns1BcqBKZ1m3yibRRicjGICaCDLLGW3RzVee/U FwlVkTE9t4EGNqtpr4bQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sEwqM-00000007OYH-2YCn; Wed, 05 Jun 2024 20:02:46 +0000 Received: from fgw23-7.mail.saunalahti.fi ([62.142.5.84]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sEwqJ-00000007OXL-03HO for linux-arm-kernel@lists.infradead.org; Wed, 05 Jun 2024 20:02:45 +0000 Received: from localhost (88-113-26-230.elisa-laajakaista.fi [88.113.26.230]) by fgw23.mail.saunalahti.fi (Halon) with ESMTP id 8aaa2179-2376-11ef-80de-005056bdfda7; Wed, 05 Jun 2024 23:02:32 +0300 (EEST) From: Andy Shevchenko Date: Wed, 5 Jun 2024 23:02:30 +0300 To: Herve Codina Cc: Simon Horman , Sai Krishna Gajula , Thomas Gleixner , Rob Herring , Krzysztof Kozlowski , Conor Dooley , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Lee Jones , Arnd Bergmann , Horatiu Vultur , UNGLinuxDriver@microchip.com, Andrew Lunn , Heiner Kallweit , Russell King , Saravana Kannan , Bjorn Helgaas , Philipp Zabel , Lars Povlsen , Steen Hegelund , Daniel Machon , Alexandre Belloni , linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, netdev@vger.kernel.org, linux-pci@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Allan Nielsen , Luca Ceresoli , Thomas Petazzoni Subject: Re: [PATCH v2 09/19] irqdomain: Add missing parameter descriptions in docs Message-ID: References: <20240527161450.326615-1-herve.codina@bootlin.com> <20240527161450.326615-10-herve.codina@bootlin.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20240527161450.326615-10-herve.codina@bootlin.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240605_130243_327982_E271C112 X-CRM114-Status: GOOD ( 11.21 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Mon, May 27, 2024 at 06:14:36PM +0200, Herve Codina kirjoitti: > During compilation, several warning of the following form were raised: > Function parameter or struct member 'x' not described in 'yyy' > > Add the missing function parameter descriptions. ... > /** > * irq_domain_translate_onecell() - Generic translate for direct one cell > * bindings > + * @d: Interrupt domain involved in the translation > + * @fwspec: The firmware interrupt specifier to translate > + * @out_hwirq: Pointer to storage for the hardware interrupt number > + * @out_type: Pointer to storage for the interrupt type (kernel-doc perhaps will complain on something missing here) > */ > int irq_domain_translate_onecell(struct irq_domain *d, You can go further and run scripts/kernel-doc -v -none -Wall ... against this file and fix more issues, like I believe in the above excerpt. -- With Best Regards, Andy Shevchenko _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel