From patchwork Fri Jan 27 08:03:52 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 13118232 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 DB11AC54EAA for ; Fri, 27 Jan 2023 08:04:10 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1625C6B0071; Fri, 27 Jan 2023 03:04:10 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 112BB6B0072; Fri, 27 Jan 2023 03:04:10 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F1CE38E0001; Fri, 27 Jan 2023 03:04:09 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id E25896B0071 for ; Fri, 27 Jan 2023 03:04:09 -0500 (EST) Received: from smtpin14.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id AFC141A0F0B for ; Fri, 27 Jan 2023 08:04:09 +0000 (UTC) X-FDA: 80399841018.14.329EF06 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf18.hostedemail.com (Postfix) with ESMTP id 0CC3C1C0019 for ; Fri, 27 Jan 2023 08:04:07 +0000 (UTC) Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Zog1O5zJ; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf18.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=rppt@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1674806648; 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-transfer-encoding:content-transfer-encoding: in-reply-to:references:dkim-signature; bh=GQgev7urFqLmPdWSgDPAa+ffW4fAYEqe6RxrZWgnQj4=; b=vkIKNoAB//CN7axbJTJhfw6KQ1bPBMbBC6Frmge+EyU0DDa9HYfIGL6WEtV8LeLIR/uqlv TX433ZkP95RXfhkEO3WYt00y8d9tKpafx0mH3VpuAi4pATE5+NYPVCyO1UgpuIeV1fhdDz DdDp3RT6/t8P0jvjq8yDQ71Fcw3pUzg= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=Zog1O5zJ; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf18.hostedemail.com: domain of rppt@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=rppt@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1674806648; a=rsa-sha256; cv=none; b=6GX18utsp8XGSRdW/5vprkcuRbLbNOokGy4P//KcqPtwxFyM9MPP9MBqvQEx2KAnsotRF/ wpB4IS1JcSl8ErKXqJi6bkh6oSlDzvrs1lEn5VGIrM4+04EFm+5FnnCt6Q1bzVlBUaBqKL N/EaWoCtIGtD6im2+TGcwZO7WEgEf/M= 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 E610B619EF; Fri, 27 Jan 2023 08:04:06 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id E8AB9C433EF; Fri, 27 Jan 2023 08:04:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1674806646; bh=PLW27rVPPgQXoOQSnxZ4p5WQWtbMJcN4Z4Y6W08+hGA=; h=From:To:Cc:Subject:Date:From; b=Zog1O5zJgSWGN0ZRHgiAnfUzzTV7lKX963HuC3SlN+JCzvHcETcXfEw+6yPGp+rwW MFZLWoiFbPpt3jERiro05ZxIA+GbR6TEGyDqiFZzcJFkMeG5kN467XSwjYTCggU4Ah kUcUpgO+7RzatdJVjMriSQ8PTuFmLGfNTXdpXbjci90odcQtg3jForgUdhTeB6CzO0 h46NWnfNLBBalR31Ae1Sm2DIAVeHz4mpxBEPzRXmCeW+PeSSYjkJ0+3kg0CsbYZ8Rs LJlDtOpwY7ZjlzebrjhpctH/MiK8UBabJN1BTofo8vK8QKjT5gXXGRV82bIzqde5mL lKEzYtXu53wCg== 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] docs/mm: Physical Memory: remove useless markup Date: Fri, 27 Jan 2023 10:03:52 +0200 Message-Id: <20230127080352.177185-1-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam02 X-Rspamd-Queue-Id: 0CC3C1C0019 X-Stat-Signature: sc4fuqm4a5ckwx3gmbgo6e889unfsfnz X-HE-Tag: 1674806647-268679 X-HE-Meta: U2FsdGVkX18OBL2eiHxnNW/0Y7MdITcE3Z3BBKDxk1cYk/nXwZGSaF63rc50CM+V90fd6k2lhgiT2Fij9TBsFw/cqyRx9VQVPSsp/kaR4r353uxCpwlBF1/8vP1XJjFso5NpO2DiM7Dz2DfHAZkhVfNZ8iv5seIRApiZpoSgZlnUnP728M6OGP60g/7MS3J32oKBNb2bCzdqgaLwKeGNhEPwkCjxR3d6Q+zqPUnL/1qG/gWS9h8O4EwQN4d7YsdX/KoUbawXj/DaHXAqSsT7p267Vq3MoX5iGJjkan6TMcwTUWA6M9scK/nTDtGrx5ePvgrMh9BIbun/QAq3a52EHGjYP81mLjrqlPsPD5ORvg/IG4fTFtZqmn0SaG0llHE6twrtrbnp8zeFKbO1S3axK9yIqCboNViYeOx7r0pt7y2kKlvt8KFXgGzUEs9Ao/yMWw+CAvf85zZddUL1mGvT0Tehof8E2Uk5AobOm8J3MUfWT0fZ1OZS97GuVOmhFjGlcwOgidiUndJRCyck7A04voa2CwGz2xW9xiI5+WYFikxtljAPj6bTTOs/vUnjqEDE6Aumm3oBQwsmeOFHRMCfq7cDMW8+vjVkOQfs2/vC/NLXX1K7evKxj4XpOqrh/Zd/B7UKZ1Ai1kwwu37DTforBMUvtcucMR51IwYR/CSwGo5uQjVZhVYUF9z2MSCEmOFh9B0VK0Dk1z+yBq8hhUSShT3kJwAQZegAmfsat3zK+6B+3aXkxBylsPVOJOpAMEdpgzAI7pX4+wJatgbF9/sGYzAPzhbiG8aFn9Us+MSVlWFSh2Cm1SbOEiL6ekGmmoRfdC8pCsQNM2fjc/oXBIJnb5pYv6qKh65N+f7CHQUuSJ0t7IIW4GFKOxl8VOKe48hndSPRoeNben/q4YMpyY9jE+Og1L7iotBXMtO7FyX5OrhC6NqunzICpAkYmLEU3O7lK7an5PR6aH0OBTGocvw Zma22vpx WJOUUyqPmi7TiEj8AJsGYVqwVxqxufktNEAQ55BLJnNpmGS+7xPTRlETPfLiL0ejKQyV9pUr0+FoUtDRq7NK6jngbe8Xz/uKdXLmcuhWIXpTcwdiZWqOBnNocvDd1cuIKeanCAiKYt7ZA29BNp9C3aem5puBNBsix3uqiQWaIq7Y/8HuXH0ReVbFn32Gh+kxvofeWFSCifGo+L29K+d8Ul4Ry8uvKfGmr4Q0udeMJRfKdFZ5CHvEU27H8lb5rysH0wYeD8bojV3rTCywRRQt3LM1V/0uZytXTTZvsxUOTJQxDI4W7yI7YPpRWnSLafVzPHEAiG1krg4MjP3hrxjOlHpZHdmW8jB9pliO944i+eVw/e1LR57e/whul/6JuxhPLt1LDIiBqh04eROnNIS4TS3R+tSSA00pU48Og 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: From: "Mike Rapoport (IBM)" Jon says: > +See also :ref:`Page Reclaim `. Can also just be "See also Documentation/mm/page_reclaim.rst". The right things will happen in the HTML output, readers of the plain-text will know immediately where to go, and we don't have to add the label clutter. Remove reference markup and unnecessary labes and use plain file names. Fixes: 5d8c5e430a63 ("docs/mm: Physical Memory: add structure, introduction and nodes description") Suggested-by: Jonathan Corbet Signed-off-by: Mike Rapoport (IBM) Acked-by: Bagas Sanjaya --- Documentation/core-api/dma-api.rst | 2 -- Documentation/mm/page_reclaim.rst | 2 -- Documentation/mm/physical_memory.rst | 6 +++--- 3 files changed, 3 insertions(+), 7 deletions(-) diff --git a/Documentation/core-api/dma-api.rst b/Documentation/core-api/dma-api.rst index c847a5b0a0d3..829f20a193ca 100644 --- a/Documentation/core-api/dma-api.rst +++ b/Documentation/core-api/dma-api.rst @@ -1,5 +1,3 @@ -.. _dma_api: - ============================================ Dynamic DMA mapping using the generic device ============================================ diff --git a/Documentation/mm/page_reclaim.rst b/Documentation/mm/page_reclaim.rst index 3fccde066436..50a30b7f8ac3 100644 --- a/Documentation/mm/page_reclaim.rst +++ b/Documentation/mm/page_reclaim.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 -.. _page_reclaim: - ============ Page Reclaim ============ diff --git a/Documentation/mm/physical_memory.rst b/Documentation/mm/physical_memory.rst index d24220d62475..120d54ba6ea7 100644 --- a/Documentation/mm/physical_memory.rst +++ b/Documentation/mm/physical_memory.rst @@ -39,8 +39,8 @@ one of the types described below. * ``ZONE_DMA`` and ``ZONE_DMA32`` historically represented memory suitable for DMA by peripheral devices that cannot access all of the addressable memory. For many years there are better more and robust interfaces to get - memory with DMA specific requirements (:ref:`DMA API `), but - ``ZONE_DMA`` and ``ZONE_DMA32`` still represent memory ranges that have + memory with DMA specific requirements (Documentation/core-api/dma-api.rst), + but ``ZONE_DMA`` and ``ZONE_DMA32`` still represent memory ranges that have restrictions on how they can be accessed. Depending on the architecture, either of these zone types or even they both can be disabled at build time using ``CONFIG_ZONE_DMA`` and @@ -252,7 +252,7 @@ General Reclaim control ~~~~~~~~~~~~~~~ -See also :ref:`Page Reclaim `. +See also Documentation/mm/page_reclaim.rst. ``kswapd`` Per-node instance of kswapd kernel thread.