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 4B523C001E0 for ; Wed, 2 Aug 2023 14:45:51 +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:MIME-Version:Message-ID:Date:References :In-Reply-To:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=N2qiE6veoXXb+tZh/EM0EyKajIxaezoHdpA5+0jqBsY=; b=Qn/ikEsdRwLc7X XH8wxfLWUssX+XXxfmE4pO1xmgucHUjUETRClzhtOGeanQE9KhZbjy/+t41nTk+VFpyfCbXmm15yl 9Ak6UtCmK33lMhwtuj577oJyfKwugxPBMQcrFIjP8ZzwuIj0FOFmzKJpjINzZbn1dnlf+PtOlq+li zwX7owOoh8jEND3qSm4Pc27M+KGzWU5VA2KEH0zr+KLSi2ZTgB0qu1OWA+OhKaxzr54yJGeEvVmBI sC0wj6Vjj+4vj4zb4xfk28vuc726VEdIy5h9FJTr5BuKli/vkw26aIvo00HUpzjI16wzv7PQ173WH +ZwFqRIyR2yuCoRc/6gQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1qRD6N-005755-1L; Wed, 02 Aug 2023 14:45:27 +0000 Received: from ms.lwn.net ([45.79.88.28]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1qRD6K-00573D-0B for linux-arm-kernel@lists.infradead.org; Wed, 02 Aug 2023 14:45:25 +0000 Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id CA048380; Wed, 2 Aug 2023 14:45:15 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net CA048380 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1690987516; bh=gjlHNSiPJH2mSvqtWTZhAzkJgjQu1TEBb+RZEZs8VC8=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=GDXKA1gx0lsSxBw05FF03T0dOuntbILT+c/h97Tdew0kSKeYeJ+2vN82Py2YHx5P7 klcB4yyhpsD7KElDrdxfPIlFCuEV0+NEaYoCAGsmYmsGJy3C3JHz/MIxzlm06h3vJB 8rqbFBcz2oW0ewXlDV49rg3nGFnfBw8qAngycoLwh/upSTevQv4p6G+y4gyChHelwi CQ0+RtM5LH8GXxMbHRpj+VPCTUikdeRsFVdKejKHs8NsfJT39RdddBbmDAnUX6CzVT o/NAOlbgSZbUVCMyIEzVT7CjijP6+sNyTeKjo/AWIK3vKVWWBIdv7hkRoSL1b5IOio wi8N/osGJSSjg== From: Jonathan Corbet To: Laurent Pinchart , Lee Jones Cc: dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, Hyun Kwon , David Airlie , Daniel Vetter , Michal Simek , linux-arm-kernel@lists.infradead.org, Mauro Carvalho Chehab Subject: Re: [PATCH 02/37] drm/xlnx/zynqmp_disp: Use correct kerneldoc formatting in zynqmp_disp In-Reply-To: <20230320231551.GQ20234@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> Date: Wed, 02 Aug 2023 08:45:15 -0600 Message-ID: <87o7jpa4g4.fsf@meer.lwn.net> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230802_074524_091250_23DCB265 X-CRM114-Status: GOOD ( 13.25 ) 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 Laurent Pinchart writes: > 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 ? As far as I can recall, nobody has ever complained about problems with nested structure definitions like that; kernel-doc certainly isn't set up to handle such a thing. It could certainly be added, but it would require somebody diving into that delightful code to do that work. I can't promise to be able to do that in the near future. Sorry, jon _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel 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 2A5ECC04E69 for ; Wed, 2 Aug 2023 14:45:19 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 1BC1510E1F6; Wed, 2 Aug 2023 14:45:19 +0000 (UTC) Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by gabe.freedesktop.org (Postfix) with ESMTPS id 8630B10E160 for ; Wed, 2 Aug 2023 14:45:16 +0000 (UTC) Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id CA048380; Wed, 2 Aug 2023 14:45:15 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net CA048380 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1690987516; bh=gjlHNSiPJH2mSvqtWTZhAzkJgjQu1TEBb+RZEZs8VC8=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=GDXKA1gx0lsSxBw05FF03T0dOuntbILT+c/h97Tdew0kSKeYeJ+2vN82Py2YHx5P7 klcB4yyhpsD7KElDrdxfPIlFCuEV0+NEaYoCAGsmYmsGJy3C3JHz/MIxzlm06h3vJB 8rqbFBcz2oW0ewXlDV49rg3nGFnfBw8qAngycoLwh/upSTevQv4p6G+y4gyChHelwi CQ0+RtM5LH8GXxMbHRpj+VPCTUikdeRsFVdKejKHs8NsfJT39RdddBbmDAnUX6CzVT o/NAOlbgSZbUVCMyIEzVT7CjijP6+sNyTeKjo/AWIK3vKVWWBIdv7hkRoSL1b5IOio wi8N/osGJSSjg== From: Jonathan Corbet To: Laurent Pinchart , Lee Jones Subject: Re: [PATCH 02/37] drm/xlnx/zynqmp_disp: Use correct kerneldoc formatting in zynqmp_disp In-Reply-To: <20230320231551.GQ20234@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> Date: Wed, 02 Aug 2023 08:45:15 -0600 Message-ID: <87o7jpa4g4.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain 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: Hyun Kwon , linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Michal Simek , Mauro Carvalho Chehab , linux-arm-kernel@lists.infradead.org Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" Laurent Pinchart writes: > 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 ? As far as I can recall, nobody has ever complained about problems with nested structure definitions like that; kernel-doc certainly isn't set up to handle such a thing. It could certainly be added, but it would require somebody diving into that delightful code to do that work. I can't promise to be able to do that in the near future. Sorry, jon 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 96AA0C001E0 for ; Wed, 2 Aug 2023 14:45:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234347AbjHBOpX (ORCPT ); Wed, 2 Aug 2023 10:45:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43384 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234343AbjHBOpS (ORCPT ); Wed, 2 Aug 2023 10:45:18 -0400 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3A1021FC6 for ; Wed, 2 Aug 2023 07:45:17 -0700 (PDT) Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id CA048380; Wed, 2 Aug 2023 14:45:15 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net CA048380 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1690987516; bh=gjlHNSiPJH2mSvqtWTZhAzkJgjQu1TEBb+RZEZs8VC8=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=GDXKA1gx0lsSxBw05FF03T0dOuntbILT+c/h97Tdew0kSKeYeJ+2vN82Py2YHx5P7 klcB4yyhpsD7KElDrdxfPIlFCuEV0+NEaYoCAGsmYmsGJy3C3JHz/MIxzlm06h3vJB 8rqbFBcz2oW0ewXlDV49rg3nGFnfBw8qAngycoLwh/upSTevQv4p6G+y4gyChHelwi CQ0+RtM5LH8GXxMbHRpj+VPCTUikdeRsFVdKejKHs8NsfJT39RdddBbmDAnUX6CzVT o/NAOlbgSZbUVCMyIEzVT7CjijP6+sNyTeKjo/AWIK3vKVWWBIdv7hkRoSL1b5IOio wi8N/osGJSSjg== From: Jonathan Corbet To: Laurent Pinchart , Lee Jones Cc: dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, Hyun Kwon , David Airlie , Daniel Vetter , Michal Simek , linux-arm-kernel@lists.infradead.org, Mauro Carvalho Chehab Subject: Re: [PATCH 02/37] drm/xlnx/zynqmp_disp: Use correct kerneldoc formatting in zynqmp_disp In-Reply-To: <20230320231551.GQ20234@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> Date: Wed, 02 Aug 2023 08:45:15 -0600 Message-ID: <87o7jpa4g4.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Laurent Pinchart writes: > 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 ? As far as I can recall, nobody has ever complained about problems with nested structure definitions like that; kernel-doc certainly isn't set up to handle such a thing. It could certainly be added, but it would require somebody diving into that delightful code to do that work. I can't promise to be able to do that in the near future. Sorry, jon