From patchwork Fri Jan 13 06:41:48 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 43025 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp122446wrt; Thu, 12 Jan 2023 22:59:27 -0800 (PST) X-Google-Smtp-Source: AMrXdXtlBr/kWgb0whUp9oseMe0L9Ecjc3Ms5ApaWhupkw6Tyt7NZT7ABZKX7adlth32d3ltum7l X-Received: by 2002:a17:906:39cc:b0:865:db90:1fd8 with SMTP id i12-20020a17090639cc00b00865db901fd8mr4766056eje.61.1673593167382; Thu, 12 Jan 2023 22:59:27 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673593167; cv=none; d=google.com; s=arc-20160816; b=HHmalO9sAFxeDawz4eDU+2mshdXv8HXNNLUDcWdzgf4MDG0yD3T6vlVmHkO8zo7Rku DBFxisqP5AhhgT3m1TFF7B4fXz5mUHF+xnmoenWNpIzSiCSAE7CdfjyIUkP6/qszoWMr 6v3fxWR45dxXWzGjmGJvnYJpNaWeLKd7ejj+sONwfOXkEoLmgt71GLZDdz+ejsNUbq1X GWDO4c89W04Avo2hHjGhiI5ST03h6AGkngliMDy1rnGZRZfZK/x77FwiKMZEZrea8Wpv 29L9kZ1CsYQQk1+PqmobSmv6fUytH+CYQe0h/FNDc4iPmrjrORWzbNaf4C+PNdsy7aqT 2lOg== 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=wZX1QHyWVerePTjeZ5i7Pceid0sAB6lehXeRpO+rbsY=; b=DROHmqF3JzLdDme99m2/5f4s1QJTHIjlvDHn2ADaj+ub4hZFAMyeHSmpO3o18gl/4/ 4oTNsMYXf97vsxLV6NeWVaiZL0GFOE4e3Mmn/IyCi2sqdYEafm3oUVrfagTmprXwgZob s45ky3tSKceoOXarEngpz3VNPZbPyLj4ABjitum1XDhWNul6OrDcKm7zXCN7vVgzV3Q8 fkWh6eXsp+Fnz2RgeTOJc75LWGj2lY8AxE4mY0uc90yNYoIND6PZ1+Mm0V9VCOvcu4Dn KczMbVVESIh/nTrtWzjfnhHYjtQqTqFP7Dipd0A/T8ZF1NEc/AbvC2SceMAnyYfe013S zkag== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=fkJCiGX3; 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 dm10-20020a170907948a00b007c144e9f270si22932370ejc.708.2023.01.12.22.59.03; Thu, 12 Jan 2023 22:59:27 -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=fkJCiGX3; 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 S240903AbjAMG6H (ORCPT + 99 others); Fri, 13 Jan 2023 01:58:07 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33656 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235057AbjAMG4Y (ORCPT ); Fri, 13 Jan 2023 01:56:24 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B124571FE1 for ; Thu, 12 Jan 2023 22:41:50 -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=wZX1QHyWVerePTjeZ5i7Pceid0sAB6lehXeRpO+rbsY=; b=fkJCiGX3uPjL4wHWfrmDG9Ht32 1bYX4lppLvWUk5bjEaJFCAO7BJNjGcv2PhIIkoBtu+/Zyv+VS5RYfnqaYfSzxp+QpywTDac/wIEbb hW1VvdunyhbeIDktd/kSJAvOrNg+nvpv3BhIjXUlwaxLYcogCBcCDbJsY4Z8uw0iJzuN6b8AxJZEk Xtm5JZg/pyCrcPUmMwNQdIzHWzEApCm4SXiXMilIylscwYIfGGG1+v6VGuWUT+Rx5wQ3nYJ+y5Z8A jROYQnuyg3k1UQ/DAC5y6/SRNGuHihFoqhGVxWB1HxYkOC4vfvTrhfON3WXFudv4lk3RMnVIi75xr AtT/yfvw==; 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 1pGDl7-000r28-18; Fri, 13 Jan 2023 06:41:49 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Evgeniy Polyakov Subject: [PATCH] w1: slaves: fix W=1 kernel-doc warnings Date: Thu, 12 Jan 2023 22:41:48 -0800 Message-Id: <20230113064148.32298-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?1754889629227462207?= X-GMAIL-MSGID: =?utf-8?q?1754889629227462207?= Fix all W=1 kernel-doc warnings in drivers/w1/ by not using "/**" to begin comments that are not in kernel-doc format. Fixes these warnings: drivers/w1/slaves/w1_ds2408.c:210: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Writing to the activity file resets the activity latches. drivers/w1/slaves/w1_ds2433.c:46: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Check the file size bounds and adjusts count as needed. drivers/w1/slaves/w1_ds2433.c:141: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Writes to the scratchpad and reads it back for verification. drivers/w1/slaves/w1_ds28e04.c:57: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Check the file size bounds and adjusts count as needed. drivers/w1/slaves/w1_ds28e04.c:149: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Writes to the scratchpad and reads it back for verification. Signed-off-by: Randy Dunlap Cc: Evgeniy Polyakov --- drivers/w1/slaves/w1_ds2408.c | 2 +- drivers/w1/slaves/w1_ds2433.c | 4 ++-- drivers/w1/slaves/w1_ds28e04.c | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff -- a/drivers/w1/slaves/w1_ds2408.c b/drivers/w1/slaves/w1_ds2408.c --- a/drivers/w1/slaves/w1_ds2408.c +++ b/drivers/w1/slaves/w1_ds2408.c @@ -206,7 +206,7 @@ out: } -/** +/* * Writing to the activity file resets the activity latches. */ static ssize_t activity_write(struct file *filp, struct kobject *kobj, diff -- a/drivers/w1/slaves/w1_ds2433.c b/drivers/w1/slaves/w1_ds2433.c --- a/drivers/w1/slaves/w1_ds2433.c +++ b/drivers/w1/slaves/w1_ds2433.c @@ -42,7 +42,7 @@ struct w1_f23_data { u32 validcrc; }; -/** +/* * Check the file size bounds and adjusts count as needed. * This would not be needed if the file size didn't reset to 0 after a write. */ @@ -137,7 +137,7 @@ out_up: return count; } -/** +/* * Writes to the scratchpad and reads it back for verification. * Then copies the scratchpad to EEPROM. * The data must be on one page. diff -- a/drivers/w1/slaves/w1_ds28e04.c b/drivers/w1/slaves/w1_ds28e04.c --- a/drivers/w1/slaves/w1_ds28e04.c +++ b/drivers/w1/slaves/w1_ds28e04.c @@ -53,7 +53,7 @@ struct w1_f1C_data { u32 validcrc; }; -/** +/* * Check the file size bounds and adjusts count as needed. * This would not be needed if the file size didn't reset to 0 after a write. */ @@ -145,7 +145,7 @@ out_up: return count; } -/** +/* * Writes to the scratchpad and reads it back for verification. * Then copies the scratchpad to EEPROM. * The data must be on one page.