From mboxrd@z Thu Jan 1 00:00:00 1970 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 1AE0CEE4997 for ; Fri, 18 Aug 2023 20:06:49 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id ACD01940078; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A7A8C940012; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 91BC8940078; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 7F09C940012 for ; Fri, 18 Aug 2023 16:06:48 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 411761211C3 for ; Fri, 18 Aug 2023 20:06:48 +0000 (UTC) X-FDA: 81138308496.09.D169BCE Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf07.hostedemail.com (Postfix) with ESMTP id 92C1840005 for ; Fri, 18 Aug 2023 20:06:46 +0000 (UTC) Authentication-Results: imf07.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=rkSXXrRq; dmarc=none; spf=none (imf07.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692389206; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=vsBXmbIBGjgL8OAsP8lhIU5HpuKdHOAcVbKVff35yq0=; b=fYiOcY8LW4RHW/zndsW3PhmYiu6C1FVeNkHxHBUw/HtZ0sCKg5GjKLd7d36PwS4yFODthU Otn+gZMSpdSIIb73LQbdbsOp/fTWX89ZnTgmaUEaKjOg0Ml8TmkXlvWU5LOvrop4w3cftk ZDT3xuFkxeb5l6RZq8I72UfcD5WCi4Q= ARC-Authentication-Results: i=1; imf07.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=rkSXXrRq; dmarc=none; spf=none (imf07.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692389206; a=rsa-sha256; cv=none; b=4oxk4GNN5qmDUw05VvRUGhNBTZlWCBfYxsfnoDtZJbY2Y2EA36rUgssTY3vp4p+mzA2Y7Y 6k7ysgBMLNUpYw3M5NG+FOL6XUyRdg675a/C+Fcvld9jIE7K6Gpryb+jUzHg8CcFbJyt7w AqHRI1KWjyxLnukoL4RObhx6HJ1TYkA= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=vsBXmbIBGjgL8OAsP8lhIU5HpuKdHOAcVbKVff35yq0=; b=rkSXXrRqZSDngZsXaXS1lbcvKi QcxZl8fRtvl2u5og3DaZCgWwOd8wNJiUmPuNozZFhK4Rp2yqmIrBH6RtwP++DppbgOZSGlhwnIezt e1vasqNE2W4aZU+QTDwKwQiw25UEVta9LR0f40lR26wYW8zzUOaRhROTU2QP+RCM811qjbWcygzK2 7Vuyv70yxpieq2E6NKpJanmkNqbcKLdBa6fsqSwE7FViFyinr4zEmkSFCp68hihuKk5XIqq9+GNHL fGl5oRgErGTMT2HUat8VgevjzrG6L30Rgiwy1OXl6ZCChibpTt3+MbcOEm7yqywAdIuemdd9xrcze 90jN3SXw==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1qX5js-00BPVC-MY; Fri, 18 Aug 2023 20:06:32 +0000 From: "Matthew Wilcox (Oracle)" To: Andrew Morton Cc: "Matthew Wilcox (Oracle)" , linux-mm@kvack.org, Mike Rapoport , linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: [PATCH 3/4] mm: Fix clean_record_shared_mapping_range kernel-doc Date: Fri, 18 Aug 2023 21:06:29 +0100 Message-Id: <20230818200630.2719595-4-willy@infradead.org> X-Mailer: git-send-email 2.37.1 In-Reply-To: <20230818200630.2719595-1-willy@infradead.org> References: <20230818200630.2719595-1-willy@infradead.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 92C1840005 X-Stat-Signature: e3aoyb33rwzcw3s5eigirdg499pmsew6 X-Rspam-User: X-HE-Tag: 1692389206-930601 X-HE-Meta: U2FsdGVkX18oT+l5v15Op0NysL1Lbi07vbiGPbZT2Bl0+DyinngKC0LCpb+UX3+xnD/1qpYn4TzcFRYI+rHkyr+vIJl1faHBjEHWqvE3NHq3vLLscyXUjoVP+Qe5CE+cZKGrvce296Ts1ZX+lu/IrRyOVRIwlp9CZx/+VMk9l9eLtVvJrwiEJIHae+3852yOnxY8OJe3NLZC9Dv0IbhobLH31zIdxa2I4100kcoaZkEnO19wq1Kc/0MrtE0+UcpuVDXBD7yB/B5m6M4ze56IPxpeTRb5vwxvKC7Bw4igFWHVpjDw6IVVFUGxjBxcrTh+a5/mLpfmVEqrU6kFKsNANtQE4AG9ZVhjXOruyV0Gr02RqK1E8HYcoEHG//jEu4rcAjThlInGcTH9Hf2xGijDH8ScMDGnLx2iKMZJpu/L8OOsxQ2fRHajGypE+DaWk31Gg3JfsCSWSyx+OzYfEri4+NNan89clpZ77FW5VWUc/O5BRGDj94OuRgR+hmWtY7nMOtBBw9cb2nxZj3DTtU+wc9ykLXqzzpX8r+rtiFXSJ1+ELHKxl9cWfWl3sL+T0X/0ioGaU0xaFm8YBfd9LBkuT6cIPZh7k16U7MbpwTOQ0TOC55o2IxYDjjUTV9Sc5Oaamsa7YpqJUeAyuhZvkMQtpwNClt34er1Ss0YPvUoqqKRsYVHNc8W4deMsmcLzcfdMicMVeFNc995gat76titOBlJ7UwGmIKxFTy2jX6KNwc7QNLWdaUDBL7nGgjyaLDyn6th74HbOW7gS2mXg9C8oPTckrxuVNPP+w0v/YSVSCiu/ge6jxPR5jeouxNtqSC3b4u31wiuhhgMlsndg+eFxKActt5RVvSvg4G58OEAIw06qYomnH5Li/4zxl4uXKBNcTjM+gb4e7QPc2u/ldDnKCGOGDcAyAi73UAs6iyDBR7kQ5omRS4zadUPaosI69O1qNW403+e/QX6cCE/Sj8Y 7UYA7YKn XIkPc2sA6J+sp+cqGawqGLQTjSkCw5yAZ7vp2p7HqSOlOx7eaK3nR413x8rjnsXzBdT/3CbLgM0402AT6SY5omY1cVRdkMJFeuIvCOq1yix+Rx9T8/14lO2u4THdv1IIuNuUq2VWxtKqRGRAbQPcjXdllZEJHn4GUYNySDAf52kzQ/wJz6cLYeQQrOgSg5SHWuez9CJN4I4dkKK7YQ5AJdJ4rmD8FsK6lwTsP 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: Turn the a), b) into an unordered ReST list and remove the unnecessary 'Note:' prefix. Signed-off-by: Matthew Wilcox (Oracle) --- mm/mapping_dirty_helpers.c | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/mm/mapping_dirty_helpers.c b/mm/mapping_dirty_helpers.c index a26dd8bcfcdb..2f8829b3541a 100644 --- a/mm/mapping_dirty_helpers.c +++ b/mm/mapping_dirty_helpers.c @@ -288,13 +288,14 @@ EXPORT_SYMBOL_GPL(wp_shared_mapping_range); * @end: Pointer to the number of the last set bit in @bitmap. * none set. The value is modified as new bits are set by the function. * - * Note: When this function returns there is no guarantee that a CPU has + * When this function returns there is no guarantee that a CPU has * not already dirtied new ptes. However it will not clean any ptes not * reported in the bitmap. The guarantees are as follows: - * a) All ptes dirty when the function starts executing will end up recorded - * in the bitmap. - * b) All ptes dirtied after that will either remain dirty, be recorded in the - * bitmap or both. + * + * * All ptes dirty when the function starts executing will end up recorded + * in the bitmap. + * * All ptes dirtied after that will either remain dirty, be recorded in the + * bitmap or both. * * If a caller needs to make sure all dirty ptes are picked up and none * additional are added, it first needs to write-protect the address-space -- 2.40.1