From patchwork Thu Jan 12 09:16:13 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 3900 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4e01:0:0:0:0:0 with SMTP id p1csp3784485wrt; Thu, 12 Jan 2023 01:28:40 -0800 (PST) X-Google-Smtp-Source: AMrXdXuFlEu2nsZ7gAeuSC6wizEf3dIe7S6uAMQ1YnR21hJV0oX6jQudx3cfbI1WJES6boqBPbh7 X-Received: by 2002:a17:90a:64c9:b0:229:a2:a273 with SMTP id i9-20020a17090a64c900b0022900a2a273mr1691346pjm.2.1673515720402; Thu, 12 Jan 2023 01:28:40 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1673515720; cv=none; d=google.com; s=arc-20160816; b=QL8SRC0UrCMbHrwX2537L382AtY607VdXTTaKj9ZV6njkgo/ozWAuxcYYkqFmlceQQ 0qxA9BrcEad1XaJ1PhNNsl1BIsJEMu2R8DyyzXUYYZa9qqp+vpoVdFww7Qr9yChD5XNd y9UaDGdS7niXpopDFAHi4oJSyMbeaqHoOKh0QEbP2/OHZCwvWDmFumcFP7NgJZjAddzG xcfcMNm3SJ2952YUyS/OqiTJK8hBunLztkfz0hr4Gp3LiK9CX8PkwN5Ro/eBwoaYJyTi U7i/EWiYy6vrIPzVgqry8g7kjB7l2bglvQzKY7svGCKktPnltRrT7VLHjwfG74aklL8V 2T+Q== 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=vR4qN6Eq9rHnNk8nwyUBk/o/E7U6r7+cL0cBCCfLzVo=; b=Pv1lROt50t6YTsIMOi5OlPFl86LA4hZZSU42AnwpXo2Q3QumQdIbN0sEhgB+9RFlFI AEFGBAFSRdwZM0zdn/qem8+lmrlV8fcLsuOJTFftLF8AGTxKFWHRV50Rn9tTl0NNG62N HKn+EyYEMKpyfBgTfe4Xq7KyO/WNido51l5DKn9mc8iDsDr4gOasbqPMaxLBn1+Pl9LJ mTHRA6xEAESm/L/qtVV2M3IZX5jt/Hn1I8ZEizyouLdhb+Sqyk2T4Utpi8goayjI+Sly vAwk63rdkw4jV3YItoS98A1+dp+l5KATybPHznbDLJb15ePLZlId1q78HLF8E/8Lk1bN STFQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=s5TvrV2i; 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 mu10-20020a17090b388a00b00219dbeefa87si18979643pjb.166.2023.01.12.01.28.28; Thu, 12 Jan 2023 01:28:40 -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=s5TvrV2i; 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 S240082AbjALJ1A (ORCPT + 99 others); Thu, 12 Jan 2023 04:27:00 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40550 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S239884AbjALJ0Y (ORCPT ); Thu, 12 Jan 2023 04:26:24 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CC6381AA34; Thu, 12 Jan 2023 01:16:32 -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 ams.source.kernel.org (Postfix) with ESMTPS id 738A1B81DBE; Thu, 12 Jan 2023 09:16:31 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7E2DDC433F0; Thu, 12 Jan 2023 09:16:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1673514990; bh=DjSUWLCCoHmwa2yENKF2bU4H10yE7Rv4+InOgRsZT5c=; h=From:To:Cc:Subject:Date:From; b=s5TvrV2ioxMpkk8qDko5R4U19/d6DJDQLJIZmFaNXAYEw4lmNVOqcnKweILqD5aer sO/DOVreeS8mQoVqizHAOUCCA7fMF+NdkKHTV08DuKMd44QdE4DWLf4JhMlqw+56OH PiXc7EuO4CjPuMnUbcMKz/6QZKAJO7j3dD3psfAfDM5fknzyeaP/prVReJeSqpRuoA SJ7zMHg6LkC8dM19htGJXRPmBQxjKI/TU+MSSpPtmPWMKQflS75nv8wKrHzVhGHWOt UTOEISTO0gk8YFvMxN+YIYrUu1RPeRCYMuvChIpW5XOUnZZfJfQ9P14DiX8VtrsKRx o4bTgJ3vDtkIQ== 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 v3 0/3] docs/mm: start filling out new structure Date: Thu, 12 Jan 2023 11:16:13 +0200 Message-Id: <20230112091616.824565-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?1754808419936341963?= X-GMAIL-MSGID: =?utf-8?q?1754808419936341963?= 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. 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. v3: * 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) (3): docs/core-api: DMA API: add page label to allow external references docs/mm: Page Reclaim: add page label to allow external references 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(+)