From patchwork Tue Nov 28 20:14:03 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alain Volmat X-Patchwork-Id: 13471716 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 70755C4167B for ; Tue, 28 Nov 2023 20:15:22 +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:Subject:CC :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=QVaOks1v33f9lGchN61EX7o55jjgndHAOHZRlyB7udI=; b=UjJ5BnKj55fiDI pM5Vh8fyrZsklbqvt7tmNidq7xruQooT5cPs75Pww+PC16lxwINxkenF/OXe+axxxwMIUMl4WodUa DwiV3N/STro0+CsrvoP0hNvSqBHHpMceKvggZMWHrXC3h2aY/FjXcaO4TYCOuzdetOSt0oumkTVOI +2IgtEEpI1MgnkBkv+UE+2b5k7zD6qA7z62U3GljC1VoKFRMVepzdzvtHi+TxCK77fXcpyUSQ2Ys0 +4arjbMa6wo9GtxiG02JF7+BJ7dFTahKU4kc6ekzYMB7a6soJJVjbnMyMKbTcXB12Iwn7H9gwmUxz lj/nw5EoIB8+stlXLZjQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1r84Tv-006Erf-0B; Tue, 28 Nov 2023 20:14:55 +0000 Received: from mx08-00178001.pphosted.com ([91.207.212.93] helo=mx07-00178001.pphosted.com) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1r84Ts-006Eqt-05 for linux-arm-kernel@lists.infradead.org; Tue, 28 Nov 2023 20:14:53 +0000 Received: from pps.filterd (m0046661.ppops.net [127.0.0.1]) by mx07-00178001.pphosted.com (8.17.1.22/8.17.1.22) with ESMTP id 3ASEWoYk025952; Tue, 28 Nov 2023 21:14:36 +0100 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=foss.st.com; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding:content-type; s=selector1; bh=3wum3M3 uGkwBSpakL3jJmsR2FXWJMQzhEHn2WaGllZI=; b=6thw0lQMM3/jSHUykSdUmg5 g60wNRp1znWXHe3w2Qdf1vqk9mqXAtsWRmJ64nfh+ovGcSocDzPeRsbcJHGs4d0D fxv0T9cvtVacdgGw/eRFDFWBOJEzZQqmhISZtPiTgxzHk5PBKnTAAIdr4yWbLP5U TvBZUWcPEMXIrS+5BI9rfNgBJzsV27q2ldmLmc61UQ1YNwtsQnEKyqODEgL6sxys 42mb6HBUuJ897KMObaTym+vAR/c/x5pAtZauXIKe0absnsJTUGEAgQP+oVsq0X5M 9vxtzMoZLNwCn69MuOXg39xWh63IzIDCvLTuKNvLDPPRgRBgcHd8G6u0ItIVKXA= = Received: from beta.dmz-eu.st.com (beta.dmz-eu.st.com [164.129.1.35]) by mx07-00178001.pphosted.com (PPS) with ESMTPS id 3uk8pjwn91-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 28 Nov 2023 21:14:36 +0100 (CET) Received: from euls16034.sgp.st.com (euls16034.sgp.st.com [10.75.44.20]) by beta.dmz-eu.st.com (STMicroelectronics) with ESMTP id 5547310002A; Tue, 28 Nov 2023 21:14:34 +0100 (CET) Received: from Webmail-eu.st.com (shfdag1node1.st.com [10.75.129.69]) by euls16034.sgp.st.com (STMicroelectronics) with ESMTP id 4A135276D9F; Tue, 28 Nov 2023 21:14:34 +0100 (CET) Received: from localhost (10.252.11.142) by SHFDAG1NODE1.st.com (10.75.129.69) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Tue, 28 Nov 2023 21:14:34 +0100 From: Alain Volmat To: Hugues Fruchet , Alain Volmat , Mauro Carvalho Chehab , Maxime Coquelin , Alexandre Torgue CC: Hans Verkuil , Sakari Ailus , , , , Subject: [PATCH] media: stm32-dcmipp: correct kerneldoc issues in dcmipp-common Date: Tue, 28 Nov 2023 21:14:03 +0100 Message-ID: <20231128201404.237856-1-alain.volmat@foss.st.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 X-Originating-IP: [10.252.11.142] X-ClientProxiedBy: EQNCAS1NODE4.st.com (10.75.129.82) To SHFDAG1NODE1.st.com (10.75.129.69) X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.997,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2023-11-28_23,2023-11-27_01,2023-05-22_02 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20231128_121452_357997_4908A195 X-CRM114-Status: GOOD ( 15.27 ) 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: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Correct kerneldoc issues regarding: - dcmipp_ent_sd_register - dcmipp_pads_init - dcmipp_colorimetry_clamp Rename as well dcmipp_pads_init parameter from pads_flag to pads_flags. Signed-off-by: Alain Volmat --- .../media/platform/st/stm32/stm32-dcmipp/dcmipp-common.c | 4 ++-- .../media/platform/st/stm32/stm32-dcmipp/dcmipp-common.h | 6 ++++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.c b/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.c index d4f149f7e1b7..562933e08d62 100644 --- a/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.c +++ b/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.c @@ -14,7 +14,7 @@ #include "dcmipp-common.h" /* Helper function to allocate and initialize pads */ -struct media_pad *dcmipp_pads_init(u16 num_pads, const unsigned long *pads_flag) +struct media_pad *dcmipp_pads_init(u16 num_pads, const unsigned long *pads_flags) { struct media_pad *pads; unsigned int i; @@ -27,7 +27,7 @@ struct media_pad *dcmipp_pads_init(u16 num_pads, const unsigned long *pads_flag) /* Initialize the pads */ for (i = 0; i < num_pads; i++) { pads[i].index = i; - pads[i].flags = pads_flag[i]; + pads[i].flags = pads_flags[i]; } return pads; diff --git a/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.h b/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.h index 5fd26d6f857a..69cfa67ffeeb 100644 --- a/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.h +++ b/drivers/media/platform/st/stm32/stm32-dcmipp/dcmipp-common.h @@ -33,7 +33,7 @@ #define DCMIPP_XFER_FUNC_DEFAULT V4L2_XFER_FUNC_DEFAULT /** - * struct dcmipp_colorimetry_clamp - Adjust colorimetry parameters + * dcmipp_colorimetry_clamp() - Adjust colorimetry parameters * * @fmt: the pointer to struct v4l2_pix_format or * struct v4l2_mbus_framefmt @@ -103,7 +103,7 @@ struct dcmipp_ent_device { * Helper functions to allocate/initialize pads */ struct media_pad *dcmipp_pads_init(u16 num_pads, - const unsigned long *pads_flag); + const unsigned long *pads_flags); /** * dcmipp_pads_cleanup - free pads @@ -130,6 +130,8 @@ static inline void dcmipp_pads_cleanup(struct media_pad *pads) * @pads_flag: flags to use in each pad * @sd_int_ops: pointer to &struct v4l2_subdev_internal_ops * @sd_ops: pointer to &struct v4l2_subdev_ops. + * @handler: func pointer of the irq handler + * @thread_fn: func pointer of the threaded irq handler * * Helper function initialize and register the struct dcmipp_ent_device and * struct v4l2_subdev which represents a subdev node in the topology