From patchwork Fri Jan 13 06:45: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: 43037 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp123278wrt; Thu, 12 Jan 2023 23:01:19 -0800 (PST) X-Google-Smtp-Source: AMrXdXu/44oBwKk079xuVc4ZlWR9CKge3zgAPfMlD+0+TFgaGG7TsX57rUf1IZV7iexUaLbuSULZ X-Received: by 2002:a17:907:7ba7:b0:864:1902:7050 with SMTP id ne39-20020a1709077ba700b0086419027050mr6366588ejc.69.1673593279777; Thu, 12 Jan 2023 23:01:19 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673593279; cv=none; d=google.com; s=arc-20160816; b=NvVW6c1IFwLly4XD1bMcF9TUUSjHqoWsOcrILKUCaxSB8bamOlx6hXdMpiEzHp/xeo ypi3nP6F3faKtqgkxiJLllbpYa8vgBc4aUDXDu8qZGXM3feMXwJJPLE4bRHkLlKaHQxb NjQTadYNO38eKxtnknWECyVfcpeg9Ek1N7kAmQM4OWO2huTCYk2k7CHQQtdfC5JTCyXT lpF/4Jxkj6KVpRg+77qYkDVsVfwMTB7ftTD/B8+xQr07S1mJavzIaYP0jCHcmpDsCKa9 jWXBgb/nyEKPa0Zc8KcZ+puBeXEANYdT6ADL6nj8PXxaoIV9vlsZNN97Dg8NcSx+hF6+ 9BJA== 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:dkim-signature; bh=09K4dkdI4zxUjfN9hP0vNQGNi8DcDHDFtxm3QRSJOl8=; b=UvupAOWm3qF5Q/F+4zztcoscqjxFWJidL5LT/gu/LTVAweNxnBDcNwpjM43ibFMKKS lrBi8maTnrcRTLoEmRkyyiZhzbYzM/wPWHRRj1Sdh2vZumce01RlnDKo7bPTUHrK0+EU LbM/n+HKXAE/zXuwR77EVBs4MXxc4RpWEBNovCejQe+rrwpsl57JuhkV7GbJ+w9DjQZ4 VGE+UYm8cI81rlkHjKOEdzbkiPgi5hLQke/SW43TgGFj93nAsrGzJYOiX2tVZSEgBWz9 itcEqpeTkmJ5wLd5eGo1erSgm3TS0CBvWvaZYNCqVuU71e/5FLXiGt+MtItyThlRTGJJ p7rQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=mJ3xHkme; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id gb23-20020a170907961700b0078e1d1d6005si22516518ejc.23.2023.01.12.23.00.55; Thu, 12 Jan 2023 23:01:19 -0800 (PST) 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; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=mJ3xHkme; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240981AbjAMHAX (ORCPT + 99 others); Fri, 13 Jan 2023 02:00:23 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33514 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S240795AbjAMG7V (ORCPT ); Fri, 13 Jan 2023 01:59:21 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 5C4666B5E3; Thu, 12 Jan 2023 22:45:41 -0800 (PST) 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:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=09K4dkdI4zxUjfN9hP0vNQGNi8DcDHDFtxm3QRSJOl8=; b=mJ3xHkmeskeJf6lJ1SV35HIbSZ 8LC0ERiioH7FZq1/DcX+ea4RM9nVneJI3S3pGidp6fikinA7bNd7xLlSdYVIbmi0ypXCiGygaNGo/ KmFx5zJ6FT36pSUd0Kv6+McYR8xWi+k3KKzHXm3p9wGOJUVXU4MCOH6CYPzzB/icp9P6/AAnxcilx 5+xLRg0fnuL28SAM9pyL1oz22jL6goQTP8fHYzcsd9Mdpx6Izf4MyAakjVCTfNm2MCDJ0/9FuFdDa qSZtVUomvC5KSc1Finjv0X2+1kLTcWSIMlH5UqIQvRXhz7H9lwZGfvVNgMnDvssPKz7qi5ajq0jsy KDpDiHRw==; Received: from [2601:1c2:d80:3110::9307] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pGDoq-000sGa-O0; Fri, 13 Jan 2023 06:45:40 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Jean Delvare , Guenter Roeck , linux-hwmon@vger.kernel.org Subject: [PATCH] hwmon: (emc2305) fix kernel-doc warnings Date: Thu, 12 Jan 2023 22:45:40 -0800 Message-Id: <20230113064540.20179-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.0 MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,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-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1754889747056600843?= X-GMAIL-MSGID: =?utf-8?q?1754889747056600843?= Fix kernel-doc warnings: drivers/hwmon/emc2305.c:62: warning: Cannot understand * @cdev: cooling device; on line 62 - I thought it was a doc line drivers/hwmon/emc2305.c:89: warning: Cannot understand * @client: i2c client; on line 89 - I thought it was a doc line and drop ';' at end of each struct member line. Signed-off-by: Randy Dunlap Cc: Jean Delvare Cc: Guenter Roeck Cc: linux-hwmon@vger.kernel.org --- drivers/hwmon/emc2305.c | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff -- a/drivers/hwmon/emc2305.c b/drivers/hwmon/emc2305.c --- a/drivers/hwmon/emc2305.c +++ b/drivers/hwmon/emc2305.c @@ -59,10 +59,11 @@ static const struct i2c_device_id emc230 MODULE_DEVICE_TABLE(i2c, emc2305_ids); /** - * @cdev: cooling device; - * @curr_state: cooling current state; - * @last_hwmon_state: last cooling state updated by hwmon subsystem; - * @last_thermal_state: last cooling state updated by thermal subsystem; + * struct emc2305_cdev_data - device-specific cooling device state + * @cdev: cooling device + * @cur_state: cooling current state + * @last_hwmon_state: last cooling state updated by hwmon subsystem + * @last_thermal_state: last cooling state updated by thermal subsystem * * The 'last_hwmon_state' and 'last_thermal_state' fields are provided to support fan low limit * speed feature. The purpose of this feature is to provides ability to limit fan speed @@ -86,13 +87,14 @@ struct emc2305_cdev_data { }; /** - * @client: i2c client; - * @hwmon_dev: hwmon device; - * @max_state: maximum cooling state of the cooling device; - * @pwm_num: number of PWM channels; - * @pwm_separate: separate PWM settings for every channel; - * @pwm_min: array of minimum PWM per channel; - * @cdev_data: array of cooling devices data; + * struct emc2305_data - device-specific data + * @client: i2c client + * @hwmon_dev: hwmon device + * @max_state: maximum cooling state of the cooling device + * @pwm_num: number of PWM channels + * @pwm_separate: separate PWM settings for every channel + * @pwm_min: array of minimum PWM per channel + * @cdev_data: array of cooling devices data */ struct emc2305_data { struct i2c_client *client;