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 5B2B2C48291 for ; Mon, 5 Feb 2024 10:40:18 +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:From:References:Cc:To: Subject:MIME-Version:Date:Message-ID:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=tFGACfTUfwoWPzGbgtQGNmOTRgXQEj8YGEEMmC9nasM=; b=VZa5h/BcWK6Ejy 6Jb0pp132HxC6EvpzbbMNtk40Kg5Oq7brpfy32HpapfNM4ClK/J2HNri+rANhruNrhJjOUUYsM3D5 FxIs4kVVuHuV6q6bkCFBLkQhy7OzzQxTcEvF8KgvjNsGuNREa2yvTZNWQZzDSXDy8x+qhFxQC8MdX +JhyGJO+jQvukR7HiHVHpE/i/Ms7aVw4obQK1jDWQn2uYc3IXojRm5jjbZGaBajiLDJy/qwURIM6P Z/VH5f2L2PIozc2Xe5qKYbOUuQxpY+aTE2BeOzzKbPJhbtlOr8zL0SBtRbxmcljCZ3Blsfg0xoDwM hS8k6ZdBS9mkpg21kTeA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rWwOS-00000002rKW-10pe; Mon, 05 Feb 2024 10:40:04 +0000 Received: from [50.53.50.0] (helo=[192.168.254.15]) by bombadil.infradead.org with esmtpsa (Exim 4.97.1 #2 (Red Hat Linux)) id 1rWwOJ-00000002rJF-3GlM; Mon, 05 Feb 2024 10:39:55 +0000 Message-ID: <8f3bab1f-8697-40c0-91f2-de934b4b9ddb@infradead.org> Date: Mon, 5 Feb 2024 02:39:53 -0800 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 17/17] linux: v4l2-vp9.h: Fix kerneldoc Content-Language: en-US To: Hans Verkuil , Ricardo Ribalda , Jonathan Corbet Cc: Tiffany Lin , Andrew-CT Chen , Yunfei Dong , Mauro Carvalho Chehab , Matthias Brugger , AngeloGioacchino Del Regno , Sakari Ailus , Laurent Pinchart , Hans Verkuil , Kieran Bingham , Bin Liu , Ezequiel Garcia , Philipp Zabel , Stanimir Varbanov , Vikash Garodia , Bryan O'Donoghue , Bjorn Andersson , Konrad Dybcio , Sylwester Nawrocki , Krzysztof Kozlowski , Alim Akhtar , Marek Szyprowski , Andrzej Hajda , Bingbu Cao , Tianshu Qiu , Greg Kroah-Hartman , Neil Armstrong , Kevin Hilman , Jerome Brunet , Martin Blumenstingl , linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, linux-rockchip@lists.infradead.org, linux-arm-msm@vger.kernel.org, linux-samsung-soc@vger.kernel.org, linux-staging@lists.linux.dev, linux-amlogic@lists.infradead.org, Sakari Ailus References: <20240126-gix-mtk-warnings-v1-0-eed7865fce18@chromium.org> <20240126-gix-mtk-warnings-v1-17-eed7865fce18@chromium.org> <201ae1d1-1e03-40e2-9cc4-49df70abb8da@xs4all.nl> From: Randy Dunlap In-Reply-To: <201ae1d1-1e03-40e2-9cc4-49df70abb8da@xs4all.nl> 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 On 2/5/24 02:29, Hans Verkuil wrote: > On 27/01/2024 10:57, Sakari Ailus wrote: >> Hi Ricardo, >> >> On Fri, Jan 26, 2024 at 11:16:16PM +0000, Ricardo Ribalda wrote: >>> Kerneldoc cannot understand arrays defined like >>> v4l2_frame_symbol_counts. >>> >>> Adding an asterisk to the name does do the trick. >>> >>> Disable the kerneldoc notation for now, it is already ignored: >>> https://docs.kernel.org/search.html?q=v4l2_vp9_frame_symbol_counts >> >> Wouldn't it be nicer to fix kerneldoc instead? It might not be difficult at >> all. >> >> Feel free to, but I can also give it a try. >> > > It would be nice to have this fixed in kerneldoc itself. I'm holding this > patch back for two weeks to see if someone wants to work on kerneldoc. > > If not, then I'll take this anyway to fix the noise in our build. > > Note that while this header is indeed ignored in the documentation, that > is really more a bug and it would be nice to actually include this header > somewhere in our documentation. So fixing these kerneldoc warnings one way > or another is something that we should do. > It's just waiting for Jon to apply it: (from Sakari) https://lore.kernel.org/all/20240131084934.191226-1-sakari.ailus@linux.intel.com/ Thanks. -- #Randy _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel