From patchwork Thu Feb 10 00:48:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 12741089 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 14114C433F5 for ; Thu, 10 Feb 2022 00:48:59 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 844D16B0078; Wed, 9 Feb 2022 19:48:58 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 7F4426B007B; Wed, 9 Feb 2022 19:48:58 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6E2E06B0080; Wed, 9 Feb 2022 19:48:58 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0140.hostedemail.com [216.40.44.140]) by kanga.kvack.org (Postfix) with ESMTP id 553F86B0078 for ; Wed, 9 Feb 2022 19:48:58 -0500 (EST) Received: from smtpin22.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with ESMTP id 020C418210EAD for ; Thu, 10 Feb 2022 00:48:58 +0000 (UTC) X-FDA: 79125035556.22.120B1A2 Received: from out30-54.freemail.mail.aliyun.com (out30-54.freemail.mail.aliyun.com [115.124.30.54]) by imf22.hostedemail.com (Postfix) with ESMTP id 405BBC0003 for ; Thu, 10 Feb 2022 00:48:55 +0000 (UTC) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R621e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01e04407;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0V41QR40_1644454130; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0V41QR40_1644454130) by smtp.aliyun-inc.com(127.0.0.1); Thu, 10 Feb 2022 08:48:51 +0800 From: Yang Li To: akpm@linux-foundation.org Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] mm/munlock: Fix kernel-doc formatting issues Date: Thu, 10 Feb 2022 08:48:49 +0800 Message-Id: <20220210004849.69017-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 X-Rspamd-Queue-Id: 405BBC0003 X-Stat-Signature: 8jyhitnrpncgz34awcd9hun5cj46x3j9 X-Rspam-User: Authentication-Results: imf22.hostedemail.com; dkim=none; dmarc=pass (policy=none) header.from=alibaba.com; spf=pass (imf22.hostedemail.com: domain of yang.lee@linux.alibaba.com designates 115.124.30.54 as permitted sender) smtp.mailfrom=yang.lee@linux.alibaba.com X-Rspamd-Server: rspam05 X-HE-Tag: 1644454135-565983 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Some functions had kernel-doc that used a hash instead of a colon to separate the parameter name from the one line description. Replacing them to remove warnings found by running scripts/kernel-doc, which is caused by using 'make W=1'. mm/mlock.c:218: warning: Function parameter or member 'page' not described in 'mlock_page' mm/mlock.c:240: warning: Function parameter or member 'page' not described in 'mlock_new_page' mm/mlock.c:260: warning: Function parameter or member 'page' not described in 'munlock_page' Reported-by: Abaci Robot Signed-off-by: Yang Li --- mm/mlock.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/mm/mlock.c b/mm/mlock.c index d50d48961b22..7fb97e1242f1 100644 --- a/mm/mlock.c +++ b/mm/mlock.c @@ -212,7 +212,7 @@ bool need_mlock_page_drain(int cpu) /** * mlock_page - mlock a page already on (or temporarily off) LRU - * @page - page to be mlocked, either a normal page or a THP head. + * @page: page to be mlocked, either a normal page or a THP head. */ void mlock_page(struct page *page) { @@ -234,7 +234,7 @@ void mlock_page(struct page *page) /** * mlock_new_page - mlock a newly allocated page not yet on LRU - * @page - page to be mlocked, either a normal page or a THP head. + * @page: page to be mlocked, either a normal page or a THP head. */ void mlock_new_page(struct page *page) { @@ -254,7 +254,7 @@ void mlock_new_page(struct page *page) /** * munlock_page - munlock a page - * @page - page to be munlocked, either a normal page or a THP head. + * @page: page to be munlocked, either a normal page or a THP head. */ void munlock_page(struct page *page) {