From patchwork Tue Jan 3 03:28: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: 38252 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp4420290wrt; Mon, 2 Jan 2023 19:30:40 -0800 (PST) X-Google-Smtp-Source: AMrXdXueO/N2UMPL2tzcB1ludz8ffSrRSyFWbnl53JJOzNWoYrV3Lr9Xk8P3g568oOblY6HQvokd X-Received: by 2002:a05:6a20:d2c6:b0:af:7233:5bfc with SMTP id ir6-20020a056a20d2c600b000af72335bfcmr70740479pzb.8.1672716640042; Mon, 02 Jan 2023 19:30:40 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1672716640; cv=none; d=google.com; s=arc-20160816; b=OJIAiV9AA0y1C+t1DB4tp59PSOS3JJHBeB0Aoge+5kmpooq2leAi4QeHv6yll9VVwx Pe2L1CYCqYInjSJXfgeEAJx82/CZhvYWSYCnfW0Aw9zmh9cD07DR0Qf0Lz7DbMj71sCj G4Ag6q7GEAzzNraEhFQXWBUUCMCYUJpgHLoq0vvy6+K7QQNim8E2E1GMDEIE4N+rzJBZ QOAPGDSWsxj26S67MU2YdxL/b4aTqMjL6+iJ9Sr3R4J+YxWVpgarmkAWdnL2DlIE2Opo 9PExv/S1nFhfnBeL7sDC+UWOmmkCdtyHE/5yXYTwLuo9nBFimCFJfagRBDEDwdX+Y/KH B5eQ== 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=ux9UnHOgyeIy1oLWAlSjkONnvKezh1R0/E+bBd7rlO8=; b=fvOs1JSzECh/NUuh7JxMRpAy46IPk/GQ7NgBIH5Kx8ssBRxRi/1IlQOlOEdJBCoO+G aohlzAumBUlPpQDOQFbVSwCtGRId61c+p6uNKT+kFmsDhXQzWy7SV8vfkbCF0wIwLXT+ WX1S7iiA97RiGKsFEMbvmRYZn1KXevhC453pKsORXI/bjX5KM/L+A0Y6u4sJ5o3UpGsn hMaXpiAX4thRqt5j+09PaLj00n9D14jgZiEqZVzfCNcwzf3xfMriMASaV5MQnvnQyh+C 1YqTbBn3PuiHA9jW+jXL7ZSdEx6M4AtORZEXzI1aoowPBNyBAmhzXG2leF+dbTaDRu9m JbgA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=PqjVZgWZ; 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 f33-20020a635561000000b0046ef21af717si32203605pgm.683.2023.01.02.19.30.27; Mon, 02 Jan 2023 19:30:40 -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=PqjVZgWZ; 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 S232790AbjACD2u (ORCPT + 99 others); Mon, 2 Jan 2023 22:28:50 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47676 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230071AbjACD2s (ORCPT ); Mon, 2 Jan 2023 22:28:48 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 47F742BDD; Mon, 2 Jan 2023 19:28:46 -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=ux9UnHOgyeIy1oLWAlSjkONnvKezh1R0/E+bBd7rlO8=; b=PqjVZgWZAGt+ihvnPlJpDTJnMA 6o3UcuSpkL2m6EfFdBRj9hcDVvNEK5dycLHKfMNGlJvcekxRgq760Ef4DBUZALijaJ4lUVBLWfbep QRoc73NuXAfsfHb7PO+OQ/qigHFoCX14sK7fTSj4HG2Zzf8E/m4Fpt1Uk5XhJjhg9/LadjhAdJUIT Xo+UiIZUGXZQ+T9Vo4MWR/5LqAcGMBHX4U8ZC83m6qAuA3vqn4II6LCDH+QfiEwatC9+dP92kbO3Y +1/VKPBpLXinufJzQzFnNxzwmJF3xVyDeDB9rn8ExxvkePjq/nVrBESJfJgir4u0GYcqnfe30XeaC QVnU/N9g==; Received: from [2601:1c2:d80:3110::a2e7] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pCXyl-00G5RC-1M; Tue, 03 Jan 2023 03:28:43 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , "Rafael J. Wysocki" , Pavel Machek , Len Brown , linux-pm@vger.kernel.org Subject: [PATCH] PM: hibernate: swap: don't use /** for non-kernel-doc comments Date: Mon, 2 Jan 2023 19:28:40 -0800 Message-Id: <20230103032840.12265-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?1753970523372678243?= X-GMAIL-MSGID: =?utf-8?q?1753970523372678243?= kernel-doc complains about multiple occurrences of "/**" being used for something that is not a kernel-doc comment, so change all of these to just use "/*" comment style. The warning message for all of these is: FILE:LINE: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst kernel/power/swap.c:585: warning: ... Structure used for CRC32. kernel/power/swap.c:600: warning: ... * CRC32 update function that runs in its own thread. kernel/power/swap.c:627: warning: ... * Structure used for LZO data compression. kernel/power/swap.c:644: warning: ... * Compression function that runs in its own thread. kernel/power/swap.c:952: warning: ... * The following functions allow us to read data using a swap map kernel/power/swap.c:1111: warning: ... * Structure used for LZO data decompression. kernel/power/swap.c:1127: warning: ... * Decompression function that runs in its own thread. Also correct one spello/typo. Signed-off-by: Randy Dunlap Cc: "Rafael J. Wysocki" Cc: Pavel Machek Cc: Len Brown Cc: linux-pm@vger.kernel.org --- kernel/power/swap.c | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff -- a/kernel/power/swap.c b/kernel/power/swap.c --- a/kernel/power/swap.c +++ b/kernel/power/swap.c @@ -581,7 +581,7 @@ static int save_image(struct swap_map_ha return ret; } -/** +/* * Structure used for CRC32. */ struct crc_data { @@ -596,7 +596,7 @@ struct crc_data { unsigned char *unc[LZO_THREADS]; /* uncompressed data */ }; -/** +/* * CRC32 update function that runs in its own thread. */ static int crc32_threadfn(void *data) @@ -623,7 +623,7 @@ static int crc32_threadfn(void *data) } return 0; } -/** +/* * Structure used for LZO data compression. */ struct cmp_data { @@ -640,7 +640,7 @@ struct cmp_data { unsigned char wrk[LZO1X_1_MEM_COMPRESS]; /* compression workspace */ }; -/** +/* * Compression function that runs in its own thread. */ static int lzo_compress_threadfn(void *data) @@ -948,9 +948,9 @@ out_finish: return error; } -/** +/* * The following functions allow us to read data using a swap map - * in a file-alike way + * in a file-like way. */ static void release_swap_reader(struct swap_map_handle *handle) @@ -1107,7 +1107,7 @@ static int load_image(struct swap_map_ha return ret; } -/** +/* * Structure used for LZO data decompression. */ struct dec_data { @@ -1123,7 +1123,7 @@ struct dec_data { unsigned char cmp[LZO_CMP_SIZE]; /* compressed buffer */ }; -/** +/* * Decompression function that runs in its own thread. */ static int lzo_decompress_threadfn(void *data)