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 B1C66C61DB3 for ; Fri, 6 Jan 2023 21:16:09 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3E6378E0002; Fri, 6 Jan 2023 16:16:09 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 396738E0001; Fri, 6 Jan 2023 16:16:09 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 25E1C8E0002; Fri, 6 Jan 2023 16:16:09 -0500 (EST) 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 179C78E0001 for ; Fri, 6 Jan 2023 16:16:09 -0500 (EST) Received: from smtpin20.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id D64E11A0F14 for ; Fri, 6 Jan 2023 21:16:08 +0000 (UTC) X-FDA: 80325632016.20.DA2D5F3 Received: from mail-wr1-f47.google.com (mail-wr1-f47.google.com [209.85.221.47]) by imf14.hostedemail.com (Postfix) with ESMTP id 2CFFF100015 for ; Fri, 6 Jan 2023 21:16:06 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=gnUAtsSO; spf=pass (imf14.hostedemail.com: domain of lstoakes@gmail.com designates 209.85.221.47 as permitted sender) smtp.mailfrom=lstoakes@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1673039767; 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=OP+YfN5L/CAL5jnc65vOTHTY7IY6KT8aEtFoTjI7ujo=; b=kRs7EaREFqIgeKOYNMlDk35GkVlxMUiqyXOburT15Q6V7mWya0NxzAKtYLEa3QlzIg9+7M Z+zbOlJmPVPZyknB9grNs0m+l3sLLt1/ZDgaiKW+Bh2t//NyaidTmhEsbWr6ZNqrWxVnEJ qpaBobcXQJG75E7UX+tf4DSAn1lWhMM= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=gnUAtsSO; spf=pass (imf14.hostedemail.com: domain of lstoakes@gmail.com designates 209.85.221.47 as permitted sender) smtp.mailfrom=lstoakes@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1673039767; a=rsa-sha256; cv=none; b=R2jYQyozfweDoFzUQlVRjn57ugYgE9LmkDqfbitzp77zjNWTcl4tPZdK7HEaELIXpsS4TJ quCaSDd06ROzDg47Dm3DZWaQiPaeWS8Y+mmBK+fTXJA2W4soI7N5I5fzknuUSz/4olLwO/ aBy5glWRDE2bVpmMatHS5h8ZBVeuic0= Received: by mail-wr1-f47.google.com with SMTP id m7so2434455wrn.10 for ; Fri, 06 Jan 2023 13:16:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=OP+YfN5L/CAL5jnc65vOTHTY7IY6KT8aEtFoTjI7ujo=; b=gnUAtsSOMFLBBLUcvV5Q0U3dKVfxAtie0fDP4YcsrbWSqEphdsCYQc0QrAwUZqBZJG ru9lMiR5yYJlxaIHYNCRq5Wojzd/cy+mkt4Jq4PMjmgFDNEjV9OE8I37N0fbdS0ltg/c qxVrUPCrHUeXbcDhUu97Q4XOJIa1Lt/6UvaTYjepQK5HWurzgRyUq9XZTUsaYoNkAQmF zw6CZ3movbDjwJ6o0XWo6rqb+DMnJq/waVH30xyzg4VhWd9iJzKFByUKBuIOSZtL+EYu k0oBYR93eAarjOop6AQgiTs8R0IrGsXUc6rXfoq3mQy5UTYHXIw9Ssw8VOnf+oVyW75f Z/jA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=OP+YfN5L/CAL5jnc65vOTHTY7IY6KT8aEtFoTjI7ujo=; b=WvBd+V7q4ZbejU1WAO00dAGLBK35x5sHi2i605t4Ag4GP4tBnFBGMNm6RSHM/5O+16 K0rSfhPVV3hKILt86xSNo14whGir8aUryUDPfH4pFjNnrK0yLONN4FGcT91R1SQZD6I5 N56USvrlvqomHIc1cIAHa5KjYRsc8mHtL/u1/f54ZsyMmB+/bLtsTeWkq9M/UpnADu4s uM0EWNiypIwdZqcJo8BZZZonC+XsFep6ff5cRuxCgNPEZppwX+WLVmeL0MARqzFwlwXB F9wauOSUQnyYbUXrp2JX7KMLqkFqZW8YRPZRFxSxsDjWlFHO0jLESxqVAv8YfHpdJRHE /BXw== X-Gm-Message-State: AFqh2kpWDcmx1APMqwn/c3le9X0IdxZxTklgHYWYV816aVdgkOfD4DkE wGTLs1T0sbDkwmO5wrr3UQI= X-Google-Smtp-Source: AMrXdXsZBmrazdAEnZS+ZMUuv0w9wkfwZTql33wtBDXFGDKMyjaLGHHnKMojyGeEMPgu6WzXPwzwpg== X-Received: by 2002:a05:6000:70a:b0:263:542c:5918 with SMTP id bs10-20020a056000070a00b00263542c5918mr39982464wrb.38.1673039765448; Fri, 06 Jan 2023 13:16:05 -0800 (PST) Received: from localhost (host81-157-153-247.range81-157.btcentralplus.com. [81.157.153.247]) by smtp.gmail.com with ESMTPSA id t17-20020a05600001d100b00241d21d4652sm2206491wrx.21.2023.01.06.13.16.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 06 Jan 2023 13:16:04 -0800 (PST) Date: Fri, 6 Jan 2023 21:16:03 +0000 From: Lorenzo Stoakes To: Mike Rapoport Cc: Jonathan Corbet , Andrew Morton , David Hildenbrand , Johannes Weiner , "Matthew Wilcox (Oracle)" , Mel Gorman , Michal Hocko , Vlastimil Babka , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: Re: [PATCH 0/2] docs/mm: start filling out new structure Message-ID: References: <20230101094523.1522109-1-rppt@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230101094523.1522109-1-rppt@kernel.org> X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 2CFFF100015 X-Stat-Signature: za1qrye6d9yyqmenxek3tt38xdp69oep X-HE-Tag: 1673039766-138228 X-HE-Meta: U2FsdGVkX1+3/qXvQHyIjKA8/kF1tbgm6/ARYX1CWJMjGkL7yuMswdU9BuIFkdBJDaY2nVOYwnK2fC9nRptqdhgcsRH+ki/1h7hYFTv9MO622/tiIrPsWOYTDZHyMx59L1x2UJdUzpZRJ1T9wgE6bPKWnrHBatmve+pfSbICVr9ClEc2/wQ8Jk+lyni6hkt1rjm0N4Fh2Jswcllm0gfpczfAb7mKiYsfGMZEEkJOxPy0thwbM5ej5CYGKUQguYJqxpETBv2KQEWGtE4qeeCFAiG+P44g+6sDmtdKJW8DimfO6lPD8j3Lf/MNJFpgAPvy975HxrkkeXzjddt38NHSb/BPXojf3C0mCAxl92hlxeUq+s3ITLavIL+zQQos3oMHpJrDaSzajMwlkwdv4qOvpbIZ47yxSru32sn22No5fPxEdInMZV16tNWTQrfvnMZa7DZPDOnG+9aIOcVoPG2RVyZzQD/FwfNgZc5eVauP9iZR611c8VkY1B9UIgddK3u4bAQ6xPX21mLmrgqtTP8T5Lm+4cQUJKPQ+KKS4htyshedaaEK3AU9ibGBKsQT/jZ6KDDrDwWgYralMT/dlqXt0WS3wT79JpVvq/CJdEljtrDP2gPWpLV+05DuUTfXqV1GkaFZoaPGoG2qf5S5ZYNiE8WhrotT8x3z0wCp7j3S6RHmxh1RPgB8Hk0spUl07bVsLvOfCNSflMpuiFOzT7uN/Hgtvb8BmQXULv3wGNTlc8VB+dZJGgs5mhBDVvDb9ftsr4B0vq1Qn48OKwQPboAhmTCIHTuHLshPFN5A590NNOhCoJqGzsxDjsMkuxZ6ysdVxvwOcy7wVUOspdRUYxbUaIzPszRMBCwdQ/c9cq3pngAHGQK9ANGJj3eGFsUF/p9FYK1VbCwztoDukgeOy4w3QVL9HD/TzEHgyfj8GnRd+D/qmXNcknwzkdRVHIMsru+JMipubizpbbInrgcKKAJ 7zNw6CZK qwgRX7XGKqKpyo4Xi5FNLID1yNX/lQIxJU8u9nVtnRWQPcsQiNkvAek6ZU1JpP+pHMeEGVrv+8IzcV+AMxzeBFUOvFw== 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 Sun, Jan 01, 2023 at 11:45:21AM +0200, Mike Rapoport wrote: > From: "Mike Rapoport (IBM)" > > Hi, > > Last year at LSF/MM Matthew promptly created the new structure for MM > documentation, but there still was no patches with content. > > I've started to work on it a while ago and I wanted to send it out in a > more complete form, but I've got distracted and didn't have time to work > on this. > > With fast changes around struct page and the threat of Lorenzo's book, > I've decided to send out what I have till now with a hope that we can > really make this a collaborative effort with people filling paragraph > here and there. :)) Don't worry, I feel as if this documentation and my book only overlap partially, so there is no reason to consider it a threat! Being a developer I love bullet points. So I will sum up my thoughts on this that way:- - I have to, practically, target a single kernel version (v6.0) if I am to stand any chance of getting this done. By the time the book is released (mid 2024 maybe even later?) it will have slid further from tip kernel so the aims of the documentation and the book naturally diverge on this basis alone. - I have to, again for entirely pragmatic reasons, target a specific architecture (x86-64) where architecture-specific discussions are to be had, another luxury the core documents cannot afford, so in this respect they must go further and be broader than my own. - The aims of the mm documentation here are, as I gather, to provide a broad overview, API guide, and general explainer. Of course the book will somewhat overlap with each of these, but I am also taking a deeply self-indulgent (and perhaps unwise) approach of going quite a bit deeper and diving into code and visualisations and providing something of a 'guided tour' of the kernel in a way that just wouldn't make sense or be probably particularly helpful in the context of mm docs. - I feel as if the two are actually symbiotic rather than in competition and I really want both to happen and be helpful to people, coming from different angles and with different aims as they do. Given your and other maintainers's competence and experience both of which dramatically eclipse mine many, many times over I am certain these documents will be excellent and will be extremely useful, I only hope that the book can at least somewhat compare! I'd like to contribute too but my time is so limited with the day job and book that I'd rather keep what time I have for kernel contributions to code/reviews in order to keep myself 'in the game' so to speak, however I am happy to review when I have a moment to! Proximally speaking, I will take a look at the actual patches here and try (humbly!) to review as best I can! I should add that I feel quite honoured to be referenced at all here! :) Cheers, Lorenzo > > If somebody does not feel like sending formal patches, just send me the > "raw" text my way and I'll deal with the rest. > > The text is relatively heavily formatted because I believe the target > audience will prefer html version. > > Mike Rapoport (IBM) (2): > docs/mm: Page Reclaim: add page label to allow external references > docs/mm: Physical Memory: add structure, introduction and nodes > description > > Documentation/mm/page_reclaim.rst | 2 + > Documentation/mm/physical_memory.rst | 322 +++++++++++++++++++++++++++ > 2 files changed, 324 insertions(+) > > -- > 2.35.1 >