From patchwork Fri Jan 13 06:45:00 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 43035 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp123228wrt; Thu, 12 Jan 2023 23:01:14 -0800 (PST) X-Google-Smtp-Source: AMrXdXvb83CBTqLgLL4r4nwRCTnYhOVi8Nlk2UI0vLljV6MA5Je8eLBTDQlIWTB2ETELtsKq/H0Q X-Received: by 2002:a17:906:36c5:b0:829:594c:8ec8 with SMTP id b5-20020a17090636c500b00829594c8ec8mr62062258ejc.29.1673593274363; Thu, 12 Jan 2023 23:01:14 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673593274; cv=none; d=google.com; s=arc-20160816; b=07qEosNYrz/Fn5etUNNpbyZihjZgVbZYx3UcJCu3b5W1EyV7Dpy3vewfgqF5OH5wK1 TuJvHneknJta2CibGyVm9IwPXVDmzVVsYzg/fewHq08sudQv7U5ks5bBTDfgDpnq0V4t 2GaRg+T3zw9sr36lPcUkBGqDmsr+SPS1dp86/Vk46cmclET3SeOo7BgBrJl6yCWFNANi 5dnd2q+HMnY3FaB/1Q6L2gtSjZzDS0FBoBNucShS7xht0LGEUnHk11a3sgO8eTQibhL0 eBSK4Zdu9SzyVLwts9d/4T2nxsUi2XEzD6EKZw5tTj4eVyuWliOMQcsgfra/rxILi8rs 7ReQ== 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=Q0w3UQ9FMb1baaM0Abx1oc6KdQ6KFkDqGd9dd6I9iOk=; b=dHqen3GRRPD5YpIXGmfLSI+9oZsUhAcFBHuEATMeO9DTmXPGMVFfaVfxpXWYsIXQgf mw0RJtGI7l2+U04qH80D6UWk2/aPku+SRSxJIMjDI01wQYz9jKWpBpF1h7b6GvAllSm6 HVeAHXCukJPGEeaGRU7A2MdBKIpzu31f+PhTXTLjRwonyi3Oap73Y+u27Vro21tsDX50 t+faiEa6PeDuguqqhD6qWo9x27nOElXgd8ETSFgJDP25kwTEe7IyA9J4T8AsMB/UFUvo 1mg/Z/HZhSf3UyEYG/4KzBZVlE30XU7j7XhYzyxRxsx5j4F63eMCHHwCHOyHK4FWO2/R Tpxg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Ooiu9MVo; 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 dn7-20020a17090794c700b007897abd2d17si22754743ejc.468.2023.01.12.23.00.50; Thu, 12 Jan 2023 23:01:14 -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=Ooiu9MVo; 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 S240575AbjAMHAP (ORCPT + 99 others); Fri, 13 Jan 2023 02:00:15 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34314 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235540AbjAMG65 (ORCPT ); Fri, 13 Jan 2023 01:58:57 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B12817288E; Thu, 12 Jan 2023 22:45:01 -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=Q0w3UQ9FMb1baaM0Abx1oc6KdQ6KFkDqGd9dd6I9iOk=; b=Ooiu9MVorI3SQOFQ2KlvZgHG5O yxXFsduQqg8E59NDKFmtBDZVI3L5dC22RLWDhR3nBn94TwzZjWPjuQXC4vAl+1ypKS9cYMNI5ObpW YlQc66GWc3kI/V+fJ9NdeqIKqFyzBSzKdgt5v+rWJGHn1+nOxveRslT2H0cksUbbD9MbSSidB34zz gp/zpgKNrgn2+JmQlw2Ko/Rx20S0sI/EMu14wxqG1eLUcjLa5gzvXhqp7DhCB5niuK7HiVCDKcfMp ST7o5f5VWa7i81dNzvKMe0+sJdn+TR/9m/g5ocXnelSQjQDmOgK6M7wFPbZD9OvWG8wtNoxj+R9Ft OXAiXqSA==; 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 1pGDoC-000rxk-Rg; Fri, 13 Jan 2023 06:45:00 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , "Rafael J. Wysocki" , Daniel Lezcano , Amit Kucheria , Zhang Rui , Heiko Stuebner , linux-pm@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-rockchip@lists.infradead.org Subject: [PATCH] thermal: rockchip: fix kernel-doc warnings Date: Thu, 12 Jan 2023 22:45:00 -0800 Message-Id: <20230113064500.16103-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?1754889740780346115?= X-GMAIL-MSGID: =?utf-8?q?1754889740780346115?= Don't use "/**" to begin non-kernel-doc comments. Convert one function description to kernel-doc format. Prevents these kernel-doc warnings: drivers/thermal/rockchip_thermal.c:64: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * The max sensors is two in rockchip SoCs. drivers/thermal/rockchip_thermal.c:179: warning: expecting prototype for TSADC Sensor Register description(). Prototype was for TSADCV2_USER_CON() instead drivers/thermal/rockchip_thermal.c:1342: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Reset TSADC Controller, reset all tsadc registers. Signed-off-by: Randy Dunlap Cc: "Rafael J. Wysocki" Cc: Daniel Lezcano Cc: Amit Kucheria Cc: Zhang Rui Cc: Heiko Stuebner Cc: linux-pm@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org Cc: linux-rockchip@lists.infradead.org --- drivers/thermal/rockchip_thermal.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff -- a/drivers/thermal/rockchip_thermal.c b/drivers/thermal/rockchip_thermal.c --- a/drivers/thermal/rockchip_thermal.c +++ b/drivers/thermal/rockchip_thermal.c @@ -60,7 +60,7 @@ enum adc_sort_mode { #include "thermal_hwmon.h" -/** +/* * The max sensors is two in rockchip SoCs. * Two sensors: CPU and GPU sensor. */ @@ -169,7 +169,7 @@ struct rockchip_thermal_data { enum tshut_polarity tshut_polarity; }; -/** +/* * TSADC Sensor Register description: * * TSADCV2_* are used for RK3288 SoCs, the other chips can reuse it. @@ -1339,7 +1339,7 @@ rockchip_thermal_register_sensor(struct } /** - * Reset TSADC Controller, reset all tsadc registers. + * rockchip_thermal_reset_controller - Reset TSADC Controller, reset all tsadc registers. * @reset: the reset controller of tsadc */ static void rockchip_thermal_reset_controller(struct reset_control *reset)