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 ECD5BC433F5 for ; Wed, 4 May 2022 20:29:35 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5CBC26B0072; Wed, 4 May 2022 16:29:35 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 57AF76B0073; Wed, 4 May 2022 16:29:35 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 442E16B0074; Wed, 4 May 2022 16:29:35 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 31CC66B0072 for ; Wed, 4 May 2022 16:29:35 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 0AFBA20967 for ; Wed, 4 May 2022 20:29:35 +0000 (UTC) X-FDA: 79429201110.09.604E543 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf01.hostedemail.com (Postfix) with ESMTP id A441440095 for ; Wed, 4 May 2022 20:29:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=/qqV45pf9tDtxRN0d4Yb9gkm6Hqp8WvOMMkH0L7ncLw=; b=DzwZYqwSE+ZxEYbCR2SE5siWbz BHkWnCcWlr7+Lfpui5gavQFRw51EXUVmb0EAXI2Unw43+hpI4xARTRhCPfUfpPkk4nSjDkQ+PlyhC C19yoPDrU6JKWDQVz6wmVH9t8WmRYw5dHdL11yMNYPHYQUT8ER9t0blHkgZ54vZ/X7TQvdZKXe7pI LMU7gWrX3o/CG81PjdIFBK/PZyc7CK0vJB3A9Xi4Ffirsny72Vx30KtorwaOu4jxrFHWI8YhI8l5O Fqwd3FGw+ionWM/c5Ed6MKl0ukun7lJr/sCIr9n2o4UHeh3EC1riMJge6RVx2iirE3zi/1IJQ95Rm xz4VnFgA==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1nmLco-00GvTi-BJ; Wed, 04 May 2022 20:29:30 +0000 Date: Wed, 4 May 2022 21:29:30 +0100 From: Matthew Wilcox To: John Hubbard Cc: linux-mm@kvack.org, linux-doc@vger.kernel.org Subject: Re: [PATCH] mm,doc: Add new documentation structure Message-ID: References: <20220503063032.3680308-1-willy@infradead.org> <20c73284-66e5-8e3a-aa78-01f982720aea@nvidia.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20c73284-66e5-8e3a-aa78-01f982720aea@nvidia.com> X-Rspamd-Queue-Id: A441440095 X-Stat-Signature: fiqj3d7rngubj91zqrkiwhdocdw11c57 X-Rspam-User: Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=DzwZYqwS; spf=none (imf01.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org; dmarc=none X-Rspamd-Server: rspam09 X-HE-Tag: 1651696165-744263 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 Wed, May 04, 2022 at 06:12:09AM -0700, John Hubbard wrote: > This needs to be properly merged with the existing index. Otherwise > the result here is very confusing because there are two summaries > and no explanation of what is going on here. > > If I get a moment today, I'll take a quick shot at at merging them, > and post some suggestions here, but just wanted to point that out > before this goes in as-is. John and I have chatted to understand what he was getting at here, but haven't had a chance to review this change in-person yet. +++ b/Documentation/vm/index.rst @@ -2,6 +2,9 @@ Linux Memory Management Documentation ===================================== +Memory Management Guide +======================= + This is a guide to understanding the memory management subsystem of Linux. If you are looking for advice on simply allocating memory, see the :ref:`memory_allocation`. For controlling and tuning guides, @@ -24,10 +27,14 @@ see the :doc:`admin guide <../admin-guide/mm/index>`. shmfs oom -This is a collection of documents about the Linux memory management (mm) -subsystem internals with different level of details ranging from notes and -mailing list responses for elaborating descriptions of data structures and -algorithms. +Legacy Documentation +==================== + +This is a collection of older documents about the Linux memory management +(mm) subsystem internals with different level of details ranging from +notes and mailing list responses for elaborating descriptions of data +structures and algorithms. It should all be integrated nicely into the +above structured documentation, or deleted if it has served its purpose. .. toctree:: :maxdepth: 1