From patchwork Sun Jan 15 18:42:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 4036 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp859470wrn; Sun, 15 Jan 2023 10:43:21 -0800 (PST) X-Google-Smtp-Source: AMrXdXvG+I6K+kkZYoy7vEF1hqCG3uHtyvEyZXPFH255FPC68IsQjQpRltMlB0locZ/CufaKBZhe X-Received: by 2002:a17:90b:8d4:b0:227:1c79:ac2b with SMTP id ds20-20020a17090b08d400b002271c79ac2bmr24345420pjb.5.1673808201371; Sun, 15 Jan 2023 10:43:21 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673808201; cv=none; d=google.com; s=arc-20160816; b=iSZHF5DNvPk8lThwbtKQ9YTRM4w8Q7z1MugyTA0CovTZXpy5AgDVXo6B7L+al4Zl4d SNEhZv/p3FMNgeuks+bnU7XuVY14GdpbUg5+VgvTWUOzX7Tw64E94Jp8N0McYiM709lB CNra4eOpdAHLWIVFm2x68iOus/mRS1ONaeiAZuV7rgCsNhnKklfJNRbGp/hGcLriOJf3 bXu8W5R/gEiLGkaPQ2EEKnxvAv3f9JkJAdT2kZbD+qxpXlhO8u0ppw44SJYYs17p2qS5 V6rBNZJWB0UEkjotwPui3aT/m8+GBF0dicG1tjGcW76GioCgMkcWD4Ow0hkeR8YUp72l O3CQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=bYVwCCeoIZuzJ6n9n08f+QhUA3CAlg2CUsVlH6jfWWU=; b=UFeInVlXZJWQT9c3vTlOr1/5rG7HtCV/+MxCPCHU/55XMxj2hTXxgv28gUmn8MHNwx WYga7wXpZ+eamRyvpkSZfGatGxwr2BlginAJ0YcUBW/LLR990EjiL6sVX+HtkRNyeSF2 434M3czsGfxiaVf84xKhg0Z8zJnsYkzRsqwUKrVNR2nV8xcGStEn+5CujkSAZuedd0U1 nPGUbPHxw4NzV/eN0pOROYp5r4ZiUk6FNkVr8j5KiSyXpzW6LJQl9aJn6u1bsOEe0aTF 60TZzLsp7DTXCTYUMe9hrM5Ua8WGU3pwFfFwfVb9MT10b1HI2uHJREVLWczeO0eQwwaf EMFA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=KgvxCLGv; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id x91-20020a17090a6c6400b00226c700afe3si30673087pjj.37.2023.01.15.10.43.08; Sun, 15 Jan 2023 10:43:21 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=KgvxCLGv; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231329AbjAOSma (ORCPT + 99 others); Sun, 15 Jan 2023 13:42:30 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40484 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231362AbjAOSm2 (ORCPT ); Sun, 15 Jan 2023 13:42:28 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3F068F744; Sun, 15 Jan 2023 10:42:27 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id C7FF360D2E; Sun, 15 Jan 2023 18:42:26 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 9587EC433EF; Sun, 15 Jan 2023 18:42:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673808146; bh=z11MFNtV3X3bexpW51OoHjzIJBfJWYhzONMb5AHF4Hs=; h=From:To:Cc:Subject:Date:From; b=KgvxCLGviINKr8HSgryYWcHu97Z6S76usHSgEw43auqHfd/fmzAGQTha7oSFnwTUj oiD69dL0laJ/5SCeZ0KjLARkAnCmZvA0503c3TRoTmhdlxQSJggGgvHYC61+vhZO9V 3KHImVs6lhJo2LlgsMvpU8acSTRhhCvgoX7pkJgjbl9FyQTbqoRM6VofW8MtamencW uC3WY3RxSJBUj163OoMmZYeuHIWl7gJYS3ptzkARJi7xIW1HZY78h8fAvznV2W5LoD dFp+QR5f7FTAAj9GaQqARJhDvTiQkxwsGmzyj/HWhyXJKdalODz3L1Job/wNSD4AXq +oid1JlGlTrDQ== From: Mike Rapoport To: Jonathan Corbet Cc: Andrew Morton , Bagas Sanjaya , David Hildenbrand , Johannes Weiner , Lorenzo Stoakes , "Matthew Wilcox (Oracle)" , Mel Gorman , Michal Hocko , Mike Rapoport , Vlastimil Babka , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH v4 0/1] docs/mm: start filling out new structure Date: Sun, 15 Jan 2023 20:42:11 +0200 Message-Id: <20230115184212.996298-1-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 X-Spam-Status: No, score=-7.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1755115108530968302?= X-GMAIL-MSGID: =?utf-8?q?1755115108530968302?= 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. 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. v4: * squash commits into one (Bagas) * fix references formatting (kbuild) * add Reviewed-by and Acked-by tags v3: https://lore.kernel.org/all/20230112091616.824565-1-rppt@kernel.org * rephrase ZONE_DMA(32) and ZONE_MOVABLE description (Michal) * add cross-reference to DMA API v2: https://lore.kernel.org/all/20230110152358.2641910-1-rppt@kernel.org * rephrase the paragraph inroducing zones (Lorenzo) * update formatting (Bagas) * add section stubs (Bagas) * small fixes here and there v1: https://lore.kernel.org/all/20230101094523.1522109-1-rppt@kernel.org Mike Rapoport (IBM) (1): docs/mm: Physical Memory: add structure, introduction and nodes description Documentation/core-api/dma-api.rst | 2 + Documentation/mm/page_reclaim.rst | 2 + Documentation/mm/physical_memory.rst | 346 +++++++++++++++++++++++++++ 3 files changed, 350 insertions(+)