From patchwork Thu Oct 12 02:48:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 151663 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2908:b0:403:3b70:6f57 with SMTP id ib8csp945384vqb; Wed, 11 Oct 2023 19:49:14 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFS/qPWm99SmFUPxYDd+XrMuOId4SNf9Ar6V4Cz0wloZmynPI3ehDYoTQFhXemAm2ut14ov X-Received: by 2002:a17:90a:4ca4:b0:274:99ed:a80c with SMTP id k33-20020a17090a4ca400b0027499eda80cmr20431041pjh.3.1697078954456; Wed, 11 Oct 2023 19:49:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697078954; cv=none; d=google.com; s=arc-20160816; b=JiYX3q51e/15bz77DaMYeoOoO8oXSJtv8tKsV1x6kVABgB03eN+fm0EQbpR5Ym1Hgc Qk8AHSuSc8tCz+xipbV6BQazWEu3tk8NVSja0pMOV1DdMeqJGWJF3PluKp9EYBpqG+oK gNRvsqphYE3FHGlfCiKZP4TwpexOjc1dOfUy7T6rFLzY1HxmFqUfHxh8+J9i1LBj69wY 3OEHPQJpd8eBtstEbc29wZdHF3uFuBLf8C8vHO9Xz6FmkRAWLbOsTX4CK5+u8ZbM3IPd +jTz2fzgCfVaB33ueAQZoLLKx8WZfZVJ9rUlXkArWErij+f20AXO7DRI8IgFuuKOOjCY 4xZg== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=9IY1frtEC2rYJqSMRCt/naGt/cJcR9rRktWt5Wfg+dM=; fh=ZbvLlniUsxGLukUHdtjOOGtwnXITbomFxOFWw6lgkU0=; b=nUdqz2tPUu/5ka5uSJtNKB7Xp2dzpKaIG2psSjfF3znrRWvickEiHLw4TUjzeSYzwn VZj04ou9HI8oik0VMciL8GP1hMLW9InqZmO4bHJngBlV0rRVTAmRX+K+o668DkOohua9 +lMhq47c0QBfb2n0U/8CezORmqliuv5Q/Ko0XhGNhl+Zfaxt1ZYjm2brapjKRE1WsoPQ zdmVwVPfqBkTukgiwanMnmBvmXwuJU6JmQvRXuY/tknGBhJwHbvTKgsAcBlQXBcehxnk VAN0xaFvhV3boNCMuhb7RnJi81QAdRvcCJQopo1mqLVTLAg5Gausz1/ze5Z50HUw+YB8 N3Mw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Kr5uISvk; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id w24-20020a17090aea1800b00274a22e6364si1158670pjy.92.2023.10.11.19.49.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 11 Oct 2023 19:49:14 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Kr5uISvk; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id C4FB681E6EFC; Wed, 11 Oct 2023 19:49:13 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376865AbjJLCtF (ORCPT + 18 others); Wed, 11 Oct 2023 22:49:05 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56868 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1345779AbjJLCsv (ORCPT ); Wed, 11 Oct 2023 22:48:51 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6D85EB6 for ; Wed, 11 Oct 2023 19:48:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=9IY1frtEC2rYJqSMRCt/naGt/cJcR9rRktWt5Wfg+dM=; b=Kr5uISvkejibDfd4bv+oLqUKK6 uvWVOYjPFk/OGSGX5Me5KH+Lrk92yFZyirFVQwEw7Ee68oseHr4TveGT+5jrze0QLMlWusR/2ZU5g 6DeMHECOMbANJG/P5stZJ/zR4rTxJfeakkaU8GsWHlq7Eas0CBgrgCbgpuiIIXjV1RPi2uQC21MrX FdEcHwc5MAiuiwtVFY9Jq1f1B8I9+6Eq3cc23yMY3NgsCtF2D8jp7tDSUpohkgi9XUC/b42vRrzCh a18NDi3AvqaxmQUFsW7VmXIMi7bnmVS/r1h9raC8IH1PeIlb1xyjbuwY0Gval91TQlK3Flua3ZWzl rG38OASA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1qqlkm-00HDiv-0f; Thu, 12 Oct 2023 02:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tomas Winkler , Arnd Bergmann , Greg Kroah-Hartman Subject: [PATCH 2/7] misc: mei: client.c: fix kernel-doc warnings Date: Wed, 11 Oct 2023 19:48:40 -0700 Message-ID: <20231012024845.29169-3-rdunlap@infradead.org> X-Mailer: git-send-email 2.42.0 In-Reply-To: <20231012024845.29169-1-rdunlap@infradead.org> References: <20231012024845.29169-1-rdunlap@infradead.org> MIME-Version: 1.0 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_NONE,SPF_NONE 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 X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 11 Oct 2023 19:49:13 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779516261352250971 X-GMAIL-MSGID: 1779516261352250971 Fix kernel-doc warnings in client.c: client.c:53: warning: contents before sections client.c:68: warning: contents before sections client.c:334: warning: contents before sections client.c:349: warning: contents before sections client.c:364: warning: contents before sections Signed-off-by: Randy Dunlap Cc: Tomas Winkler Cc: Arnd Bergmann Cc: Greg Kroah-Hartman --- drivers/misc/mei/client.c | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff -- a/drivers/misc/mei/client.c b/drivers/misc/mei/client.c --- a/drivers/misc/mei/client.c +++ b/drivers/misc/mei/client.c @@ -48,9 +48,9 @@ struct mei_me_client *mei_me_cl_get(stru /** * mei_me_cl_release - free me client * - * Locking: called under "dev->device_lock" lock - * * @ref: me_client refcount + * + * Locking: called under "dev->device_lock" lock */ static void mei_me_cl_release(struct kref *ref) { @@ -63,9 +63,9 @@ static void mei_me_cl_release(struct kre /** * mei_me_cl_put - decrease me client refcount and free client if necessary * - * Locking: called under "dev->device_lock" lock - * * @me_cl: me client + * + * Locking: called under "dev->device_lock" lock */ void mei_me_cl_put(struct mei_me_client *me_cl) { @@ -329,10 +329,10 @@ void mei_io_cb_free(struct mei_cl_cb *cb /** * mei_tx_cb_enqueue - queue tx callback * - * Locking: called under "dev->device_lock" lock - * * @cb: mei callback struct * @head: an instance of list to queue on + * + * Locking: called under "dev->device_lock" lock */ static inline void mei_tx_cb_enqueue(struct mei_cl_cb *cb, struct list_head *head) @@ -344,9 +344,9 @@ static inline void mei_tx_cb_enqueue(str /** * mei_tx_cb_dequeue - dequeue tx callback * - * Locking: called under "dev->device_lock" lock - * * @cb: mei callback struct to dequeue and free + * + * Locking: called under "dev->device_lock" lock */ static inline void mei_tx_cb_dequeue(struct mei_cl_cb *cb) { @@ -359,10 +359,10 @@ static inline void mei_tx_cb_dequeue(str /** * mei_cl_set_read_by_fp - set pending_read flag to vtag struct for given fp * - * Locking: called under "dev->device_lock" lock - * * @cl: mei client * @fp: pointer to file structure + * + * Locking: called under "dev->device_lock" lock */ static void mei_cl_set_read_by_fp(const struct mei_cl *cl, const struct file *fp)