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 gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (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 6D76CEB64DD for ; Tue, 1 Aug 2023 22:36:37 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 9797C10E1F0; Tue, 1 Aug 2023 22:36:36 +0000 (UTC) Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by gabe.freedesktop.org (Postfix) with ESMTPS id EB85210E1F0 for ; Tue, 1 Aug 2023 22:36:34 +0000 (UTC) Received: from pendragon.ideasonboard.com (213-243-189-158.bb.dnainternet.fi [213.243.189.158]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 1CEDCD51; Wed, 2 Aug 2023 00:35:30 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1690929330; bh=xKbWPPFqpYA/6VBABvjVJI4UBDFcYiEPeXYPgjlljN8=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=mfJpv3RWOrBUwo+xcEdhwgoYYXmsrd5dAJersIzx0x5DE58dlbOhd94MOd0PWq+0h REZKXRoXQLfIdSImu+BP9ihvUKSZ77ABlpk/slUjfGMDqdy3lInxKkew2zjCmbA3Rd 3F7EuXwGPW2zZrC6A/Ejld/GELV8BNey0Jh3xdoo= Date: Wed, 2 Aug 2023 01:36:39 +0300 From: Laurent Pinchart To: Jonathan Corbet , Mauro Carvalho Chehab Subject: Re: [PATCH 02/37] drm/xlnx/zynqmp_disp: Use correct kerneldoc formatting in zynqmp_disp Message-ID: <20230801223639.GA335@pendragon.ideasonboard.com> References: <20230317081718.2650744-1-lee@kernel.org> <20230317081718.2650744-3-lee@kernel.org> <20230319142432.GM10144@pendragon.ideasonboard.com> <20230320081700.GH9667@google.com> <20230320231551.GQ20234@pendragon.ideasonboard.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20230320231551.GQ20234@pendragon.ideasonboard.com> X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: linux-arm-kernel@lists.infradead.org, Lee Jones , linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Michal Simek Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Jon, Mauro, would you have any feedback on this ? On Tue, Mar 21, 2023 at 01:15:51AM +0200, Laurent Pinchart wrote: > Hi Lee, > > (CC'ing Jon and Mauro) > > On Mon, Mar 20, 2023 at 08:17:00AM +0000, Lee Jones wrote: > > On Sun, 19 Mar 2023, Laurent Pinchart wrote: > > > Thank you for the patch. > > > > > > On Fri, Mar 17, 2023 at 08:16:43AM +0000, Lee Jones wrote: > > > > Fixes the following W=1 kernel build warning(s): > > > > > > > > drivers/gpu/drm/xlnx/zynqmp_disp.c:151: warning: Function parameter or member 'blend' not described in 'zynqmp_disp' > > > > drivers/gpu/drm/xlnx/zynqmp_disp.c:151: warning: Function parameter or member 'avbuf' not described in 'zynqmp_disp' > > > > drivers/gpu/drm/xlnx/zynqmp_disp.c:151: warning: Function parameter or member 'audio' not described in 'zynqmp_disp' > > > > > > > > Cc: Hyun Kwon > > > > Cc: Laurent Pinchart > > > > Cc: David Airlie > > > > Cc: Daniel Vetter > > > > Cc: Michal Simek > > > > Cc: dri-devel@lists.freedesktop.org > > > > Cc: linux-arm-kernel@lists.infradead.org > > > > Signed-off-by: Lee Jones > > > > --- > > > > drivers/gpu/drm/xlnx/zynqmp_disp.c | 6 +++--- > > > > 1 file changed, 3 insertions(+), 3 deletions(-) > > > > > > > > diff --git a/drivers/gpu/drm/xlnx/zynqmp_disp.c b/drivers/gpu/drm/xlnx/zynqmp_disp.c > > > > index 3b87eebddc979..63358f4898625 100644 > > > > --- a/drivers/gpu/drm/xlnx/zynqmp_disp.c > > > > +++ b/drivers/gpu/drm/xlnx/zynqmp_disp.c > > > > @@ -128,9 +128,9 @@ struct zynqmp_disp_layer { > > > > * struct zynqmp_disp - Display controller > > > > * @dev: Device structure > > > > * @dpsub: Display subsystem > > > > - * @blend.base: Register I/O base address for the blender > > > > - * @avbuf.base: Register I/O base address for the audio/video buffer manager > > > > - * @audio.base: Registers I/O base address for the audio mixer > > > > + * @blend: .base: Register I/O base address for the blender > > > > + * @avbuf: .base: Register I/O base address for the audio/video buffer manager > > > > + * @audio: .base: Registers I/O base address for the audio mixer > > > > > > This is a hack, it won't work properly if the nested structures get > > > extended with more fields. > > > > The original doc is a hack, for it is not recognised kerneldoc format. :) > > I'll claim it's a bug, not a hack :-D > > > > Is there a correct kerneldoc syntax for this code construct ? > > > > Not that I'm aware of. > > > > Unless it's been added since my last round of this stuff. > > I haven't seen anything either. I tried moving the documentation inline, > and the scripts/kernel-doc script ignores the comment blocks for the > inner fields. > > Mauro, Jon, is this a known issue ? If so, are there plans to fix it ? > What's the recommended way to proceed here ? > > > > > * @layers: Layers (planes) > > > > */ > > > > struct zynqmp_disp { -- Regards, Laurent Pinchart