Received: by 2002:a05:6358:c692:b0:131:369:b2a3 with SMTP id fe18csp1801074rwb; Wed, 26 Jul 2023 19:51:14 -0700 (PDT) X-Google-Smtp-Source: APBJJlE3PIyheK1JLHZ+wwei9Tn9mfaAvdrECwYbY5eCC/C2Xo+GW4wx5GFLwunVTDHLxl2B4+RM X-Received: by 2002:a17:906:2189:b0:997:ea90:96b4 with SMTP id 9-20020a170906218900b00997ea9096b4mr655913eju.61.1690426274040; Wed, 26 Jul 2023 19:51:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1690426274; cv=none; d=google.com; s=arc-20160816; b=y/88+A2SKJl2Dcgffe8C49HdcFBD6BbZimkEnEAHlfEM/tTwsupR6azi3q/0qULymn hVJfKVNr/SSaPH7ecX2Yr33AdE/j7xzulnjODEcvJ+FmnG916oxZg7XUXn3ZFND28XwV 8HovyfB6EvDSwXYg7bTPIXy6xnab5xo3ahrL17XIoaXWovkkBNQcMA9/rC6zsItSnaoj WqzjVA0xsLqx6vnmfU7SWPPVJ/9ztnjGi+VOGcpWAnI7ASFFRZbs70MmyRs4Kp9idE2h R1rYRiy1AqlXFEZJ62C8cUbvT1wzKhlNU1Tow3HPQ19xNlnmVzIXWFMIG8AGVZShwaUa FdhQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=4MPBaRKmakclpUeaiUGAu9sI8nHTUazWqmqTXnUazOQ=; fh=XjFs0gJ8ChDn4egVQ92bPLNfdyiY6bXDkYjjk+eIMBM=; b=NEhmEOxyKvfR/MMbupew8VQRWYqCfU6zgOeWKzEkuzartQ/UMBpnNEeQG/Ana7QZeq VVDValHIv/xgLIr8MHFz43OLDkMypI6XiJzX/6NTr3ardMvUvEtma7JB6ZUF0twzx6W6 bLQHzhUoJuW3q9ledRT31uC0u6Mubkf4DvWJ2oPs3vTps/WO9szf6lO/nCVXJfz0ujfV 6lfMiM2rJfj883SQXhWXALnk5IYByTu07Wxq3OMhJPH5kmO47DnVl79Iz25SlVOUVXLw J4dZjSJTndb6uStI2YT/i6hxnOUwvXEUtAKEQdX5rmA2qUyRuto4MHEMJ2ZTihc1gpxh mRpQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id p2-20020a170906838200b009938248d370si280824ejx.2.2023.07.26.19.50.49; Wed, 26 Jul 2023 19:51:14 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230285AbjG0CIr (ORCPT + 99 others); Wed, 26 Jul 2023 22:08:47 -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: 8bit X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY,USER_IN_DEF_SPF_WL autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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 'val' 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 'val' description in 'tsi721_cwrite_dma' drivers/rapidio/devices/tsi721.c:2548: warning: Function parameter or member '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=5997 Signed-off-by: Yang Li --- 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/tsi721.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, int 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. */ -- 2.20.1.7.g153144c