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 41436EE49AA for ; Mon, 21 Aug 2023 14:56:18 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id A5058940008; Mon, 21 Aug 2023 10:56:17 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A00CE8E0006; Mon, 21 Aug 2023 10:56:17 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 8C8ED940008; Mon, 21 Aug 2023 10:56:17 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 7CB7C8E0006 for ; Mon, 21 Aug 2023 10:56:17 -0400 (EDT) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 4C918120C46 for ; Mon, 21 Aug 2023 14:56:17 +0000 (UTC) X-FDA: 81148412394.29.1C5648D Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf22.hostedemail.com (Postfix) with ESMTP id A45D7C001D for ; Mon, 21 Aug 2023 14:56:15 +0000 (UTC) Authentication-Results: imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=k6PRd1kp; spf=pass (imf22.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1692629775; 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-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=MuqMmFWOn7lzchGfy2tRfYvT5k1R0fTcQ82mA/JTmJ4=; b=iDRR086dmQw+SrOIfob2W3EQGmEs+LgFjn95sWQw2IW6RFIG+jZ6YGKMjtygNOuuqTgdz4 oxcDwcKu/yH194zQPqKOfyqcbXWYcQNLzbALJCHJLeESsAKqC6gWAYEt2oOFy0hPRDfz9U l2DTa7ajpdXSbTOIoZa4q0QeG7BpEO8= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1692629775; a=rsa-sha256; cv=none; b=W6JPB3m+ziBTGaBxFCUwMMVqQ6IetG5mFyg5u4d60ndEtpvaKJZZik7QuhbTexveI1h7nt yI2D7sYejJ58lA4MipX4QSM/ARkOuaIpcD2Ol8tf3lnLgCvQy9l0cGJUOy/nz08Bmvgd3/ 0KfMZJAPhjXXIZi4E3F7yaXvsZVQa0o= ARC-Authentication-Results: i=1; imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=k6PRd1kp; spf=pass (imf22.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id EF65D6125B; Mon, 21 Aug 2023 14:56:14 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id B5023C433C7; Mon, 21 Aug 2023 14:56:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1692629774; bh=JzR+Jr/LbLcg3R+8alMuMPEoX/4+6Yrco6xCCTNqmmI=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=k6PRd1kpuLk4oe04CIlvYkbQxfyIIYRNqOxLmMc04/9+2rjj6g6Ut6iZXGnB5Ldva v78sy92rfrpcA9dkV2fWwK5KAxV63wElUa1P0Kz0SrgZ+C6WLBADa9pHaMiWpzUjeP pDXYif0syTetoV2/u3tD8eHuoHSSF3puadWCBKN5fCxji6kkL+FwQK2d7WRKj3Pzpl XmjCoW66X28u7nHPxmdleBUquaXrn/OPV3d4YcEYIKUYKRD6tO/vOKVN0YopTn9mSS q0HT2omqz5fVrqL+HOfrcvit2vpzIfJDMcJyWlW+Oii9WwU4w9pvdaLBeFZgvxadqr 5eExUI6OVyqHQ== Date: Mon, 21 Aug 2023 17:55:48 +0300 From: Mike Rapoport To: "Matthew Wilcox (Oracle)" Cc: Andrew Morton , linux-mm@kvack.org, linux-doc@vger.kernel.org, cgroups@vger.kernel.org Subject: Re: [PATCH 4/4] mm: Add orphaned kernel-doc to the rst files. Message-ID: <20230821145548.GE9849@kernel.org> References: <20230818200630.2719595-1-willy@infradead.org> <20230818200630.2719595-5-willy@infradead.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230818200630.2719595-5-willy@infradead.org> X-Rspamd-Queue-Id: A45D7C001D X-Rspam-User: X-Rspamd-Server: rspam11 X-Stat-Signature: zb5uzia8wmak5qnc1899priq1y8rim5k X-HE-Tag: 1692629775-885635 X-HE-Meta: U2FsdGVkX1/Q6pv4AUhEzzXuBZC1Izsx34l411B80FNRhhEORMim8IvJ1IUMcNDap52TPZciG09yj01VGAR+VxFx8ZaOkX5T6fLkfmMiShcM51hofWNWczC5JxNXUHUAGCczB4Tzbw06YWlIOK50uFoP7DJRHhSkiBT36Hx0Z5J+v1f7Nf/GPi8kAlbRPVHtWlNOR7J+Xc3grBm7I17IkajjN1xHKDm1U05xMw+S0SLNf3QI3NZgnoz7TePd25YV5dqz+/xqisZNcZZwra3fGm4m87KpqZgqSDMh/VJUBpK+5Scvgrlcl5qg3f4/YcyHBY01r5IwsmjIcmaf7+97fkldPcxHjGO8AyiukZ5RZI9wj0VvHRbwU0h8IQ6j3xJOYCtao773dcRrBT/rEdhfC8/1aNeFPh0nCqsNIx0LeFWj7NkyjTvLZ2Vc6T6poknk6wf4vuHG/uYReYnIYcsK/JrDXqjJnjQnlDcLp02eLWCNhCxQNjizoa4CBtDulyFcTBv8DGHOSjkssr9rNRHfRkiF7We3ugl73l+07akRLw4So5hiWlSjJp+YYQ7s1cKD83gBJVXzcD0HUVyp98EA312Myh7NBQKsKbxjPAzoI1uUwt5kFBiWEXzc7iHIbyB69v0CsyBzw6CCEdxirtvkHvARLWxJJT0JmHDXP71nxPhVyiG+ECDX4EgvvzXRhbDmJCi9B+R436lZS5MtHcuc4/9AaZJAuWhU/Kd/JbnWK3GgNVEqZcgBAP7pfCtCz6m0M8vlsHLO7CvVOEtWG/qqIp8yLGsxBTxWrMSfSBPuUA1nN8qN/Nta+ybr0hbQeFSv7lLF9vJym5FQRHFVitsXvILfDlvtlYmt0NyFpreKUNgLQxb/yZs7qMdWI7k7t1BsDP7qRFSAndhbF4hiBrxeDF41aXilxeKExSlXqmQpjYoRUKxRiON6ttsabFQcVvkyu6z4IOM+hzb2jbv2sU2 BpoJxg7J Ha1hnBR/a9RicJHaS81TWuzjvppuckmCF/HL4Ygq7C+J54Eak6awHXhZbMXDhfYA/4sWO/FZivIM5ecZdjb/sobz/m1Za6zB18Lnu35me+/KBrg46NPZj0Ii/AXHUNciCiYu2XRknLT015QtVnLJtLdLCNjIYYHDmO6aI/VeSeNcCfH2rPgssw7+6lXA0vhvyfV9y8tDZT49Lqg+9sP6Eic9GPEyqzmH+zCfvOeTlu9i72vNS/qHGZ/36vuN/KtL4GTKQ5A2I2bafrtAaQBthl8ojmo9M6TQrvquAY0kdTFbcrWnaYSVvol2CFxHeoC0bvtHEE2iiMPH3gQlOBalCz2akc/robKBWiRyL2np4NSzPvIx9Dv94Of/vJ2QhAGRtO15m5e9Qm6LyPKr4AGc93+JaTg== 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: On Fri, Aug 18, 2023 at 09:06:30PM +0100, Matthew Wilcox (Oracle) wrote: > There are many files in mm/ that contain kernel-doc which is not > currently published on kernel.org. Some of it is easily categorisable, > but most of it is going into the miscellaneous documentation section to > be organised later. > > Some files aren't ready to be included; they contain documentation with > build errors. Or they're nommu.c which duplicates documentation from > "real" MMU systems. Those files are noted with a # mark (although really > anything which isn't a recognised directive would do to prevent inclusion) > > Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Mike Rapoport (IBM) > --- > Documentation/core-api/mm-api.rst | 25 +++++++++++++++++++++++++ > Documentation/mm/highmem.rst | 1 + > Documentation/mm/zsmalloc.rst | 5 +++++ > 3 files changed, 31 insertions(+) > > diff --git a/Documentation/core-api/mm-api.rst b/Documentation/core-api/mm-api.rst > index f5dde5bceaea..2d091c873d1e 100644 > --- a/Documentation/core-api/mm-api.rst > +++ b/Documentation/core-api/mm-api.rst > @@ -115,3 +115,28 @@ More Memory Management Functions > .. kernel-doc:: include/linux/mmzone.h > .. kernel-doc:: mm/util.c > :functions: folio_mapping > + > +.. kernel-doc:: mm/rmap.c > +.. kernel-doc:: mm/migrate.c > +.. kernel-doc:: mm/mmap.c > +.. kernel-doc:: mm/kmemleak.c > +.. #kernel-doc:: mm/hmm.c (build warnings) > +.. kernel-doc:: mm/memremap.c > +.. kernel-doc:: mm/hugetlb.c > +.. kernel-doc:: mm/swap.c > +.. kernel-doc:: mm/zpool.c > +.. kernel-doc:: mm/memcontrol.c > +.. #kernel-doc:: mm/memory-tiers.c (build warnings) > +.. kernel-doc:: mm/shmem.c > +.. kernel-doc:: mm/migrate_device.c > +.. #kernel-doc:: mm/nommu.c (duplicates kernel-doc from other files) > +.. kernel-doc:: mm/mapping_dirty_helpers.c > +.. #kernel-doc:: mm/memory-failure.c (build warnings) > +.. kernel-doc:: mm/percpu.c > +.. kernel-doc:: mm/maccess.c > +.. kernel-doc:: mm/vmscan.c > +.. kernel-doc:: mm/memory_hotplug.c > +.. kernel-doc:: mm/mmu_notifier.c > +.. kernel-doc:: mm/balloon_compaction.c > +.. kernel-doc:: mm/huge_memory.c > +.. kernel-doc:: mm/io-mapping.c > diff --git a/Documentation/mm/highmem.rst b/Documentation/mm/highmem.rst > index fe68e02fc8ff..9d92e3f2b3d6 100644 > --- a/Documentation/mm/highmem.rst > +++ b/Documentation/mm/highmem.rst > @@ -209,4 +209,5 @@ Functions > ========= > > .. kernel-doc:: include/linux/highmem.h > +.. kernel-doc:: mm/highmem.c > .. kernel-doc:: include/linux/highmem-internal.h > diff --git a/Documentation/mm/zsmalloc.rst b/Documentation/mm/zsmalloc.rst > index a3c26d587752..76902835e68e 100644 > --- a/Documentation/mm/zsmalloc.rst > +++ b/Documentation/mm/zsmalloc.rst > @@ -263,3 +263,8 @@ is heavy internal fragmentation and zspool compaction is unable to relocate > objects and release zspages. In these cases, it is recommended to decrease > the limit on the size of the zspage chains (as specified by the > CONFIG_ZSMALLOC_CHAIN_SIZE option). > + > +Functions > +========= > + > +.. kernel-doc:: mm/zsmalloc.c > -- > 2.40.1 > -- Sincerely yours, Mike.