From nobody Sat Feb 7 15:12:38 2026 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 3F6C7C0015E for ; Thu, 27 Jul 2023 02:08:49 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229552AbjG0CIs (ORCPT ); Wed, 26 Jul 2023 22:08:48 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40250 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230093AbjG0CIq (ORCPT ); Wed, 26 Jul 2023 22:08:46 -0400 Received: from out30-119.freemail.mail.aliyun.com (out30-119.freemail.mail.aliyun.com [115.124.30.119]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CD3EA1BDA for ; Wed, 26 Jul 2023 19:08:44 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R101e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0VoIhlPv_1690423721; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VoIhlPv_1690423721) by smtp.aliyun-inc.com; Thu, 27 Jul 2023 10:08:41 +0800 From: Yang Li To: mporter@kernel.crashing.org, alex.bou9@gmail.com Cc: linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] rapidio/tsi721: Fix some kernel-doc comments Date: Thu, 27 Jul 2023 10:08:40 +0800 Message-Id: <20230727020840.87684-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Fix some kernel-doc comments to silence the warnings: drivers/rapidio/devices/tsi721.c:215: warning: Function parameter or member= 'data' not described in 'tsi721_cread_dma' drivers/rapidio/devices/tsi721.c:215: warning: Excess function parameter 'v= al' description in 'tsi721_cread_dma' drivers/rapidio/devices/tsi721.c:238: warning: Function parameter or member= 'data' not described in 'tsi721_cwrite_dma' drivers/rapidio/devices/tsi721.c:238: warning: Excess function parameter 'v= al' description in 'tsi721_cwrite_dma' drivers/rapidio/devices/tsi721.c:2548: warning: Function parameter or membe= r 'attr' not described in 'tsi721_query_mport' drivers/rapidio/devices/tsi721.c:2548: warning: Excess function parameter '= mbox' description in 'tsi721_query_mport' Reported-by: Abaci Robot Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=3D5997 Signed-off-by: Yang Li Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- drivers/rapidio/devices/tsi721.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/drivers/rapidio/devices/tsi721.c b/drivers/rapidio/devices/tsi= 721.c index 83323c3d10af..3e67001702bc 100644 --- a/drivers/rapidio/devices/tsi721.c +++ b/drivers/rapidio/devices/tsi721.c @@ -205,7 +205,7 @@ static int tsi721_maint_dma(struct tsi721_device *priv,= u32 sys_size, * @hopcount: Number of hops to target device * @offset: Offset into configuration space * @len: Length (in bytes) of the maintenance transaction - * @val: Location to be read into + * @data: Location to be read into * * Generates a RapidIO maintenance read transaction. * Returns %0 on success and %-EINVAL or %-EFAULT on failure. @@ -228,7 +228,7 @@ static int tsi721_cread_dma(struct rio_mport *mport, in= t index, u16 destid, * @hopcount: Number of hops to target device * @offset: Offset into configuration space * @len: Length (in bytes) of the maintenance transaction - * @val: Value to be written + * @data: Value to be written * * Generates a RapidIO maintenance write transaction. * Returns %0 on success and %-EINVAL or %-EFAULT on failure. @@ -2539,7 +2539,7 @@ static int tsi721_messages_init(struct tsi721_device = *priv) /** * tsi721_query_mport - Fetch inbound message from the Tsi721 MSG Queue * @mport: Master port implementing the Inbound Messaging Engine - * @mbox: Inbound mailbox number + * @attr: RIO mport device attributes * * Returns pointer to the message on success or NULL on failure. */ --=20 2.20.1.7.g153144c