From patchwork Wed Feb 1 09:41:54 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mike Rapoport X-Patchwork-Id: 13123998 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 C0EB2C05027 for ; Wed, 1 Feb 2023 09:42:16 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 15CFC6B0072; Wed, 1 Feb 2023 04:42:16 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 11A966B0074; Wed, 1 Feb 2023 04:42:16 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id ECAB26B0075; Wed, 1 Feb 2023 04:42:15 -0500 (EST) 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 E0A756B0072 for ; Wed, 1 Feb 2023 04:42:15 -0500 (EST) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id AFE251A0252 for ; Wed, 1 Feb 2023 09:42:15 +0000 (UTC) X-FDA: 80418232230.24.AB03019 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf28.hostedemail.com (Postfix) with ESMTP id 8CCB0C000D for ; Wed, 1 Feb 2023 09:42:13 +0000 (UTC) Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=LbRn4123; spf=pass (imf28.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1675244533; a=rsa-sha256; cv=none; b=Cb3jejKIXtsA3qMzCUvC8Bc7ZKoyuub7c1PT6C1SmiHeSeXPNiUBIiKMR9XPBeQELVlgjl xDFjLqKA5ZtEDlWmi7McGB3Vn0J4okc/JLBpPPzOAnkYsjxNKbTTpY7CdD9zCgiJxP/E+C 8BrXo/xCLzWX12sUrwC985MA8uIIZ3o= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=LbRn4123; spf=pass (imf28.hostedemail.com: domain of rppt@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=rppt@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1675244533; 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:in-reply-to:references:references:dkim-signature; bh=uGi+V5Y0nOKjcxn+/znr6RnDWyBMfcwg8vWx4XSQ4Bg=; b=tKGP7kVK5e3/ZmkuRbLhoRRyqGO8+r3i0W4H0wal/703rDP07FNQIFudHMiQQHsUYp3jnw ASkN0kC3dj6CwQN/3FnTl7tQGoKvD11njQ8iStzFZJ+pawWczjLGbioM+uDbfDI/AappRI EnpAZmCIfmj4YHZYUoYztNPbqrYG0m8= 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 4C568B82151; Wed, 1 Feb 2023 09:42:12 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 3D8B1C433D2; Wed, 1 Feb 2023 09:42:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1675244531; bh=fyLlrQ6ozpspF/7rhlxFsw35A1aS+p/JI5vd/nqAEI8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=LbRn4123EqJwl5vEXwKvzNGH6riD3I4I8aAz+Bht3IeAsN9v/FQtOQDySY6xwCW++ J76LeDvdGxFuaiZI9wS25/zn4SS2p0HRbPitWmdPEf7QCh4zpPuox6WOWZZNE8MAEG ag74tfu35YPsO/TUR6hAYEIUVlIUkHesj/LPxDwImyWSiy7jAlrFbabrvfOZ0W2aes bxWMOBNUvVA/pSsFPwogytySjjvjzHMDwUvJvUrFq2iGo+AEzRiCLXU00FQ0l4uUJi LOHLmsZvU91nMYrqatg0Zc0qb4E+8bjgiklJOM74gBjaaax7PJjQA42qdcNDmxyobq Gh6fhOMgdbaNg== From: Mike Rapoport To: Jonathan Corbet Cc: Bagas Sanjaya , Mike Rapoport , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [PATCH v3 1/3] docs/mm: Physical Memory: remove useless markup Date: Wed, 1 Feb 2023 11:41:54 +0200 Message-Id: <20230201094156.991542-2-rppt@kernel.org> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20230201094156.991542-1-rppt@kernel.org> References: <20230201094156.991542-1-rppt@kernel.org> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: 8CCB0C000D X-Rspamd-Server: rspam01 X-Stat-Signature: a1kiyre9a9hxo9d1f97mcnaydiz6knsi X-HE-Tag: 1675244533-58936 X-HE-Meta: U2FsdGVkX19dQioZspV99XNy+yR32lAABsvwgbNzc+usgt6cg4qyOTlrn8xxmw92hGI+tPALN/d3yMUBjd4kL/Cru/DIX84h8a1LvZc6gDx6toNnV7B8wdnJDqj0pNND0/iTGJEn22zkLeNyw8hpbGQzTr0yW82SYJKVAExX9dfF2ohv6QqepASrc8wcgr18lZgs18RNKjkp18pQLHka3nOYhXjv3W9i2nFLD/cdXwCqBPa7xWfoQ90eYrFZPYDoViKhVtL5DGtvjMutpCm1hxJicTR+FeIEvdgbQtC9txsVddAIngrsDuishJIZhx69SWGLU86L6qzoHVPhb2VRBQuMIESVjShWgBbH/fWSrC+Ia16pnel7ssdsBHRUIX4edNjEtOCOMX91UulXzxZCQ0AhZdEsECOu0xrZxDza/rCSevBw7Qh+kXKQQppol7Sl+VXh7tmWFzFE+99+3CchEyD3U8wxEB6rsHYbMLkp3bqic7e/SSzF/er1VMdn2bvhENX7B3N9XoYiAFZsDJPkavLKM68Bt32s1oPoacE2Dc39NN0pE6bm2Mg4r+G7DxqoXCjKH+sizJvVE4wgEWL+KdL7SRgx4zG/RsoOdlmDzZi/poTVtNneGzaBSlOv+E2XVu+7Zei98G3zY831eVG1c5uSM8sLJZ1KMqc8SrxeGmPGTecs05USKvsXucWpdToE8DG9J5RNNuCF7of50KW2LijYydtsRYM//gtKwFaefi0FIdX2A6IswXQ8KXahs+/FWQvadpMDzDntskoBUY6lSS31LobhcycqfSY/gYdHBSa9uogdsCZiZgj9NOKdMgp/y8WNx1e0FMAqRpiMMsci5tIljXUYteA19x7XOE/veoTPGQDVk7eptF8SIftCSsxJZfhcvsL0qCeqWHoEp1DZQZ78nyXn/hIq21oFnKLeB104DZOHBjiLFj2U9lo6nzhRHd9af5M1d3Mhy8+4t8u 07tzKBAq nDfj4VGqMtcmn0WKaKtzPGP8yFn6Ei0qBv2ydFLpzqHz0Io8WJdYXCUVmwWxadazZ8PL6lDRk5dIw5x3AFTeF7FR0rBtfIVkY1sl2GXUkPHH4so6CJV7NphQrXfVFI0X7eQe4bEeriNxi0tiEC1DGjMKRv2wVHmwfhgxrt4LF2W0fIaHw8FAJfm0JMk+BdNlD/w/3hFe6Kdsqyoi2b3rJUkLvKWCRIrMOdDwnf72jdUNNYeqXbonlVWLgzaA3N01NkugzWlSlcUbwbiS5STYhkCIgdhxpbHF4ZSvx9zs7L9Z9xtjN+D2eqz08SHnO/EoJwexMwtfsIugujHnDSr4Duxch1Sk3NlUgm1rTbkjdZ75JFrGxUAUGdlYRzTfWwYGvVdJyXMpm4q4d7X8Xj0hEG2qc8Liqa8l0ZNTEBtMxrLcPpOJgnkIVuOsuPw== 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 Acked-by: Bagas Sanjaya Signed-off-by: Mike Rapoport (IBM) --- Documentation/core-api/dma-api.rst | 2 -- Documentation/mm/page_reclaim.rst | 2 -- Documentation/mm/physical_memory.rst | 12 ++++++------ 3 files changed, 6 insertions(+), 10 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..3f3c02aa6e6e 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 @@ -64,9 +64,9 @@ one of the types described below. change, their content may move between different physical pages. Often ``ZONE_MOVABLE`` is populated during memory hotplug, but it may be also populated on boot using one of ``kernelcore``, ``movablecore`` and - ``movable_node`` kernel command line parameters. See :ref:`Page migration - ` and :ref:`Memory Hot(Un)Plug ` - for additional details. + ``movable_node`` kernel command line parameters. See + Documentation/mm/page_migration.rst and + Documentation/admin-guide/mm/memory_hotplug.rst for additional details. * ``ZONE_DEVICE`` represents memory residing on devices such as PMEM and GPU. It has different characteristics than RAM zone types and it exists to provide @@ -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.