Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs/mm: Physical Memory: remove useless markup

Jon says:

> +See also :ref:`Page Reclaim <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 <corbet@lwn.net>
Acked-by: Bagas Sanjaya <bagasdotme@gmail.com>
Signed-off-by: Mike Rapoport (IBM) <rppt@kernel.org>
Link: https://lore.kernel.org/r/20230201094156.991542-2-rppt@kernel.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Mike Rapoport (IBM) and committed by
Jonathan Corbet
353c7dd6 7c841564

+6 -10
-2
Documentation/core-api/dma-api.rst
··· 1 - .. _dma_api: 2 - 3 1 ============================================ 4 2 Dynamic DMA mapping using the generic device 5 3 ============================================
-2
Documentation/mm/page_reclaim.rst
··· 1 1 .. SPDX-License-Identifier: GPL-2.0 2 2 3 - .. _page_reclaim: 4 - 5 3 ============ 6 4 Page Reclaim 7 5 ============
+6 -6
Documentation/mm/physical_memory.rst
··· 39 39 * ``ZONE_DMA`` and ``ZONE_DMA32`` historically represented memory suitable for 40 40 DMA by peripheral devices that cannot access all of the addressable 41 41 memory. For many years there are better more and robust interfaces to get 42 - memory with DMA specific requirements (:ref:`DMA API <dma_api>`), but 43 - ``ZONE_DMA`` and ``ZONE_DMA32`` still represent memory ranges that have 42 + memory with DMA specific requirements (Documentation/core-api/dma-api.rst), 43 + but ``ZONE_DMA`` and ``ZONE_DMA32`` still represent memory ranges that have 44 44 restrictions on how they can be accessed. 45 45 Depending on the architecture, either of these zone types or even they both 46 46 can be disabled at build time using ``CONFIG_ZONE_DMA`` and ··· 64 64 change, their content may move between different physical pages. Often 65 65 ``ZONE_MOVABLE`` is populated during memory hotplug, but it may be 66 66 also populated on boot using one of ``kernelcore``, ``movablecore`` and 67 - ``movable_node`` kernel command line parameters. See :ref:`Page migration 68 - <page_migration>` and :ref:`Memory Hot(Un)Plug <admin_guide_memory_hotplug>` 69 - for additional details. 67 + ``movable_node`` kernel command line parameters. See 68 + Documentation/mm/page_migration.rst and 69 + Documentation/admin-guide/mm/memory_hotplug.rst for additional details. 70 70 71 71 * ``ZONE_DEVICE`` represents memory residing on devices such as PMEM and GPU. 72 72 It has different characteristics than RAM zone types and it exists to provide ··· 252 252 Reclaim control 253 253 ~~~~~~~~~~~~~~~ 254 254 255 - See also :ref:`Page Reclaim <page_reclaim>`. 255 + See also Documentation/mm/page_reclaim.rst. 256 256 257 257 ``kswapd`` 258 258 Per-node instance of kswapd kernel thread.