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 14003C433EF for ; Wed, 4 May 2022 17:01:54 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 46A3D6B0071; Wed, 4 May 2022 13:01:53 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 41A116B0073; Wed, 4 May 2022 13:01:53 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 309686B0074; Wed, 4 May 2022 13:01:53 -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 20DD86B0071 for ; Wed, 4 May 2022 13:01:53 -0400 (EDT) Received: from smtpin04.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id D4CCF210F4 for ; Wed, 4 May 2022 17:01:52 +0000 (UTC) X-FDA: 79428677664.04.B062B74 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf13.hostedemail.com (Postfix) with ESMTP id C6DE720099 for ; Wed, 4 May 2022 17:01:38 +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-Transfer-Encoding: Content-Type:MIME-Version:References:Message-ID:Subject:Cc:To:From:Date: Sender:Reply-To:Content-ID:Content-Description; bh=v7ka0WKmQ2WZWPS8VfL2i/QsDhNvSLXXHEw1/dKzozA=; b=ka9YIS3GjIF3S480f6vg4EHbFE 0mb04Oxy2DbduSE/5Vubg3FPV6Zi1PEN2YQcfDtZ4j0RC4LzaFVs8EZaQE0TNAybyvhwXzPuSBAF/ FQNzQbQyKDbfdeVswiizn0LmmydoFwuURYW1MFBs3H2SorY6jHkzYA3ho6oe63Uayb6wNaUkvIbMx f6ks/wUy4Ono2cLwGq5GmqRJ9d1EOIq9eyz/Dj6/S93m1cPI6eOK3hi5MrwOfCD9qAfkDtWPGlZE1 Snf8Zz8YgrLQ0KoYjvgxxsJmycWfd6sA5qP2g4T2yZzeA5PONyD3ozqL0jdGAQgJbS4tVZ7YmoETV 8wqZ601w==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1nmINo-00Gl2g-VC; Wed, 04 May 2022 17:01:49 +0000 Date: Wed, 4 May 2022 18:01:48 +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=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20c73284-66e5-8e3a-aa78-01f982720aea@nvidia.com> X-Rspamd-Queue-Id: C6DE720099 X-Stat-Signature: j91kzhoc69efqc64a7cw8shmo44wo7w6 Authentication-Results: imf13.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=ka9YIS3G; dmarc=none; spf=none (imf13.hostedemail.com: domain of willy@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=willy@infradead.org X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1651683698-914227 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: > > @@ -2,12 +2,32 @@ > > Linux Memory Management Documentation > > ===================================== > > +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, > > +see the :doc:`admin guide <../admin-guide/mm/index>`. > > 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. Hm? It reads OK to me the way I sent it out: Linux Memory Management Documentation¶ This is a guide to understanding the memory management subsystem of Linux. If you are looking for advice on simply allocating memory, see the Memory Allocation Guide. For controlling and tuning guides, see the admin guide. [... list ...] 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. [... another list ...] > 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. Happy to sit down with you in a free moment. I have all this on my laptop, including an htmldocs built version.