From nobody Sat Sep 13 16:38:31 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0A475C38142 for ; Wed, 1 Feb 2023 09:42:25 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232159AbjBAJmW (ORCPT ); Wed, 1 Feb 2023 04:42:22 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58352 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232132AbjBAJmP (ORCPT ); Wed, 1 Feb 2023 04:42:15 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0CF635EFA1; Wed, 1 Feb 2023 01:42:13 -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 524BDB82153; 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" 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/dm= a-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: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Dynamic DMA mapping using the generic device =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/page_reclaim.rst b/Documentation/mm/page_recl= aim.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 =20 -.. _page_reclaim: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Page Reclaim =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/physical_memory.rst b/Documentation/mm/physic= al_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.rs= t), + but ``ZONE_DMA`` and ``ZONE_DMA32`` still represent memory ranges that h= ave restrictions on how they can be accessed. Depending on the architecture, either of these zone types or even they b= oth 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. =20 * ``ZONE_DEVICE`` represents memory residing on devices such as PMEM and G= PU. It has different characteristics than RAM zone types and it exists to pr= ovide @@ -252,7 +252,7 @@ General Reclaim control ~~~~~~~~~~~~~~~ =20 -See also :ref:`Page Reclaim `. +See also Documentation/mm/page_reclaim.rst. =20 ``kswapd`` Per-node instance of kswapd kernel thread. --=20 2.35.1 From nobody Sat Sep 13 16:38:31 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 51085C05027 for ; Wed, 1 Feb 2023 09:42:34 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232154AbjBAJmd (ORCPT ); Wed, 1 Feb 2023 04:42:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58348 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232147AbjBAJmU (ORCPT ); Wed, 1 Feb 2023 04:42:20 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CCE1B5DC3B; Wed, 1 Feb 2023 01:42:16 -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 C831DB820FE; Wed, 1 Feb 2023 09:42:14 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 83425C4339B; Wed, 1 Feb 2023 09:42:11 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1675244533; bh=8IL9177iDUVTWFImzws1ExqCOazIxjzkkyC9YYfBRkw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iU9nXthCQy5DSIoAsDMUqqx2TxVBB0dEVwVfGQ8mo1Ni7VCMOR2iYF5xFs3VCWQIz lpwHrePy/OJeeHkNyh8DzKVBFlPx/6RLSm2+R2bHGvuXXOuIABzg/+LfbA9FCfaaaW Eu8LFJXW2vGNG40TodVS64V9m+jKO2Ni1SR5SMJ+tPC1xRml2j2GzW/KDPavIyq7VP R+8xzy0OmwJ5qbeJz5boOYtHgsThIpgPyzqxQfQvmU++4tKIAGAB4kmPPBmFELclLk pTl5R59uW/S679/UNbKyyCxooBOIPmnTgSa/6wRhCrVJ98Fcm0STPraGzAu2adWZIk MUYa1bNiL82Bg== 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 2/3] docs/mm: remove useless markup Date: Wed, 1 Feb 2023 11:41:55 +0200 Message-Id: <20230201094156.991542-3-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 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: "Mike Rapoport (IBM)" It is enough to use a file name to cross-reference another rst document. Jon says: 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. Drop reference markup and unnecessary labels and use plain file names. Signed-off-by: Mike Rapoport (IBM) --- Documentation/mm/active_mm.rst | 2 -- Documentation/mm/arch_pgtable_helpers.rst | 2 -- Documentation/mm/balance.rst | 2 -- Documentation/mm/free_page_reporting.rst | 2 -- Documentation/mm/frontswap.rst | 2 -- Documentation/mm/highmem.rst | 2 -- Documentation/mm/hmm.rst | 4 +--- Documentation/mm/hugetlbfs_reserv.rst | 4 +--- Documentation/mm/hwpoison.rst | 2 -- Documentation/mm/ksm.rst | 4 +--- Documentation/mm/memory-model.rst | 2 -- Documentation/mm/mmu_notifier.rst | 2 -- Documentation/mm/numa.rst | 4 +--- Documentation/mm/page_frags.rst | 2 -- Documentation/mm/page_migration.rst | 6 ++---- Documentation/mm/page_owner.rst | 2 -- Documentation/mm/page_table_check.rst | 2 -- Documentation/mm/remap_file_pages.rst | 2 -- Documentation/mm/slub.rst | 2 -- Documentation/mm/split_page_table_lock.rst | 2 -- Documentation/mm/transhuge.rst | 2 -- Documentation/mm/unevictable-lru.rst | 2 -- Documentation/mm/z3fold.rst | 2 -- Documentation/mm/zsmalloc.rst | 2 -- Documentation/translations/zh_CN/mm/hmm.rst | 2 +- Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst | 2 +- Documentation/translations/zh_CN/mm/numa.rst | 2 +- 27 files changed, 9 insertions(+), 57 deletions(-) diff --git a/Documentation/mm/active_mm.rst b/Documentation/mm/active_mm.rst index 6f8269c284ed..45d89f8fb3a8 100644 --- a/Documentation/mm/active_mm.rst +++ b/Documentation/mm/active_mm.rst @@ -1,5 +1,3 @@ -.. _active_mm: - =3D=3D=3D=3D=3D=3D=3D=3D=3D Active MM =3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/arch_pgtable_helpers.rst b/Documentation/mm/a= rch_pgtable_helpers.rst index fd2a19df884e..30d9a09f01f4 100644 --- a/Documentation/mm/arch_pgtable_helpers.rst +++ b/Documentation/mm/arch_pgtable_helpers.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 =20 -.. _arch_page_table_helpers: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D Architecture Page Table Helpers =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/balance.rst b/Documentation/mm/balance.rst index 6a1fadf3e173..6cd0127154ac 100644 --- a/Documentation/mm/balance.rst +++ b/Documentation/mm/balance.rst @@ -1,5 +1,3 @@ -.. _balance: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Memory Balancing =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/free_page_reporting.rst b/Documentation/mm/fr= ee_page_reporting.rst index 8c05e62d8b2b..1468f71c261f 100644 --- a/Documentation/mm/free_page_reporting.rst +++ b/Documentation/mm/free_page_reporting.rst @@ -1,5 +1,3 @@ -.. _free_page_reporting: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Free Page Reporting =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/frontswap.rst b/Documentation/mm/frontswap.rst index feecc5e24477..c892412988af 100644 --- a/Documentation/mm/frontswap.rst +++ b/Documentation/mm/frontswap.rst @@ -1,5 +1,3 @@ -.. _frontswap: - =3D=3D=3D=3D=3D=3D=3D=3D=3D Frontswap =3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/highmem.rst b/Documentation/mm/highmem.rst index 0f731d9196b0..bb3f90e195fa 100644 --- a/Documentation/mm/highmem.rst +++ b/Documentation/mm/highmem.rst @@ -1,5 +1,3 @@ -.. _highmem: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D High Memory Handling =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/hmm.rst b/Documentation/mm/hmm.rst index f2a59ed82ed3..9aa512c3a12c 100644 --- a/Documentation/mm/hmm.rst +++ b/Documentation/mm/hmm.rst @@ -1,5 +1,3 @@ -.. _hmm: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Heterogeneous Memory Management (HMM) =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -304,7 +302,7 @@ devm_memunmap_pages(), and devm_release_mem_region() wh= en the resources can be tied to a ``struct device``. =20 The overall migration steps are similar to migrating NUMA pages within sys= tem -memory (see :ref:`Page migration `) but the steps are split +memory (see Documentation/mm/page_migration.rst) but the steps are split between device driver specific code and shared common code: =20 1. ``mmap_read_lock()`` diff --git a/Documentation/mm/hugetlbfs_reserv.rst b/Documentation/mm/huget= lbfs_reserv.rst index f143954e0d05..05a44760da32 100644 --- a/Documentation/mm/hugetlbfs_reserv.rst +++ b/Documentation/mm/hugetlbfs_reserv.rst @@ -1,5 +1,3 @@ -.. _hugetlbfs_reserve: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Hugetlbfs Reservation =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -7,7 +5,7 @@ Hugetlbfs Reservation Overview =3D=3D=3D=3D=3D=3D=3D=3D =20 -Huge pages as described at :ref:`hugetlbpage` are typically +Huge pages as described at Documentation/mm/hugetlbpage.rst are typically preallocated for application use. These huge pages are instantiated in a task's address space at page fault time if the VMA indicates huge pages are to be used. If no huge page exists at page fault time, the task is sent diff --git a/Documentation/mm/hwpoison.rst b/Documentation/mm/hwpoison.rst index b9d5253c1305..ba48a441feed 100644 --- a/Documentation/mm/hwpoison.rst +++ b/Documentation/mm/hwpoison.rst @@ -1,5 +1,3 @@ -.. hwpoison: - =3D=3D=3D=3D=3D=3D=3D=3D hwpoison =3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/ksm.rst b/Documentation/mm/ksm.rst index f83cfbc12f4c..2806e3e4a10e 100644 --- a/Documentation/mm/ksm.rst +++ b/Documentation/mm/ksm.rst @@ -1,5 +1,3 @@ -.. _ksm: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Kernel Samepage Merging =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -8,7 +6,7 @@ KSM is a memory-saving de-duplication feature, enabled by C= ONFIG_KSM=3Dy, added to the Linux kernel in 2.6.32. See ``mm/ksm.c`` for its implementat= ion, and http://lwn.net/Articles/306704/ and https://lwn.net/Articles/330589/ =20 -The userspace interface of KSM is described in :ref:`Documentation/admin-g= uide/mm/ksm.rst ` +The userspace interface of KSM is described in Documentation/admin-guide/m= m/ksm.rst =20 Design =3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/memory-model.rst b/Documentation/mm/memory-mo= del.rst index 3779e562dc76..5f3eafbbc520 100644 --- a/Documentation/mm/memory-model.rst +++ b/Documentation/mm/memory-model.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 =20 -.. _physical_memory_model: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Physical Memory Model =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/mmu_notifier.rst b/Documentation/mm/mmu_notif= ier.rst index df5d7777fc6b..c687bea4922f 100644 --- a/Documentation/mm/mmu_notifier.rst +++ b/Documentation/mm/mmu_notifier.rst @@ -1,5 +1,3 @@ -.. _mmu_notifier: - When do you need to notify inside page table lock ? =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 diff --git a/Documentation/mm/numa.rst b/Documentation/mm/numa.rst index e1410974c941..0f1b56809dca 100644 --- a/Documentation/mm/numa.rst +++ b/Documentation/mm/numa.rst @@ -1,5 +1,3 @@ -.. _numa: - Started Nov 1999 by Kanoj Sarcar =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -110,7 +108,7 @@ to improve NUMA locality using various CPU affinity com= mand line interfaces, such as taskset(1) and numactl(1), and program interfaces such as sched_setaffinity(2). Further, one can modify the kernel's default local allocation behavior using Linux NUMA memory policy. [see -:ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `]. +Documentation/admin-guide/mm/numa_memory_policy.rst]. =20 System administrators can restrict the CPUs and nodes' memories that a non- privileged user can specify in the scheduling or NUMA commands and functio= ns diff --git a/Documentation/mm/page_frags.rst b/Documentation/mm/page_frags.= rst index 7d6f9385d129..a81617e688a8 100644 --- a/Documentation/mm/page_frags.rst +++ b/Documentation/mm/page_frags.rst @@ -1,5 +1,3 @@ -.. _page_frags: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Page fragments =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/page_migration.rst b/Documentation/mm/page_mi= gration.rst index 11493bad7112..313dce18893e 100644 --- a/Documentation/mm/page_migration.rst +++ b/Documentation/mm/page_migration.rst @@ -1,5 +1,3 @@ -.. _page_migration: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Page migration =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -9,8 +7,8 @@ nodes in a NUMA system while the process is running. This m= eans that the virtual addresses that the process sees do not change. However, the system rearranges the physical location of those pages. =20 -Also see :ref:`Heterogeneous Memory Management (HMM) ` -for migrating pages to or from device private memory. +Also see Documentation/mm/hmm.rst for migrating pages to or from device +private memory. =20 The main intent of page migration is to reduce the latency of memory acces= ses by moving pages near to the processor where the process accessing that mem= ory diff --git a/Documentation/mm/page_owner.rst b/Documentation/mm/page_owner.= rst index 0f4cb59bcaf4..e8d5090a9e6b 100644 --- a/Documentation/mm/page_owner.rst +++ b/Documentation/mm/page_owner.rst @@ -1,5 +1,3 @@ -.. _page_owner: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D page owner: Tracking about who allocated each page =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D diff --git a/Documentation/mm/page_table_check.rst b/Documentation/mm/page_= table_check.rst index 1a09472f10a3..cfd8f4117cf3 100644 --- a/Documentation/mm/page_table_check.rst +++ b/Documentation/mm/page_table_check.rst @@ -1,7 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 =20 -.. _page_table_check: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Page Table Check =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/remap_file_pages.rst b/Documentation/mm/remap= _file_pages.rst index 7bef6718e3a9..297091ce257c 100644 --- a/Documentation/mm/remap_file_pages.rst +++ b/Documentation/mm/remap_file_pages.rst @@ -1,5 +1,3 @@ -.. _remap_file_pages: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D remap_file_pages() system call =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/slub.rst b/Documentation/mm/slub.rst index 7f652216dabe..fa01cdfd7d3a 100644 --- a/Documentation/mm/slub.rst +++ b/Documentation/mm/slub.rst @@ -1,5 +1,3 @@ -.. _slub: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D Short users guide for SLUB =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D diff --git a/Documentation/mm/split_page_table_lock.rst b/Documentation/mm/= split_page_table_lock.rst index c08919662704..50ee0dfc95be 100644 --- a/Documentation/mm/split_page_table_lock.rst +++ b/Documentation/mm/split_page_table_lock.rst @@ -1,5 +1,3 @@ -.. _split_page_table_lock: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Split page table lock =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/transhuge.rst b/Documentation/mm/transhuge.rst index ec3dc5b04226..9d924b651c61 100644 --- a/Documentation/mm/transhuge.rst +++ b/Documentation/mm/transhuge.rst @@ -1,5 +1,3 @@ -.. _transhuge: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D Transparent Hugepage Support =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D diff --git a/Documentation/mm/unevictable-lru.rst b/Documentation/mm/unevic= table-lru.rst index 4a0e158aa9ce..b5dc98cd1ba8 100644 --- a/Documentation/mm/unevictable-lru.rst +++ b/Documentation/mm/unevictable-lru.rst @@ -1,5 +1,3 @@ -.. _unevictable_lru: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D Unevictable LRU Infrastructure =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/z3fold.rst b/Documentation/mm/z3fold.rst index 224e3c61d686..25b5935d06c7 100644 --- a/Documentation/mm/z3fold.rst +++ b/Documentation/mm/z3fold.rst @@ -1,5 +1,3 @@ -.. _z3fold: - =3D=3D=3D=3D=3D=3D z3fold =3D=3D=3D=3D=3D=3D diff --git a/Documentation/mm/zsmalloc.rst b/Documentation/mm/zsmalloc.rst index 6e79893d6132..24616a7c115a 100644 --- a/Documentation/mm/zsmalloc.rst +++ b/Documentation/mm/zsmalloc.rst @@ -1,5 +1,3 @@ -.. _zsmalloc: - =3D=3D=3D=3D=3D=3D=3D=3D zsmalloc =3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/translations/zh_CN/mm/hmm.rst b/Documentation/tr= anslations/zh_CN/mm/hmm.rst index 5024a8a15516..babbbe756c0f 100644 --- a/Documentation/translations/zh_CN/mm/hmm.rst +++ b/Documentation/translations/zh_CN/mm/hmm.rst @@ -248,7 +248,7 @@ migrate_vma_finalize() =E5=87=BD=E6=95=B0=E6=97=A8=E5= =9C=A8=E4=BD=BF=E9=A9=B1=E5=8A=A8=E7=A8=8B=E5=BA=8F=E6=9B=B4=E6=98=93=E4=BA= =8E=E7=BC=96=E5=86=99=E5=B9=B6=E9=9B=86=E4=B8=AD=E8=B7=A8=E9=A9=B1 =E8=BF=98=E6=9C=89devm_request_free_mem_region(), devm_memremap_pages(), devm_memunmap_pages() =E5=92=8C devm_release_mem_region() =E5=BD=93=E8=B5= =84=E6=BA=90=E5=8F=AF=E4=BB=A5=E7=BB=91=E5=AE=9A=E5=88=B0 ``struct device``. =20 -=E6=95=B4=E4=BD=93=E8=BF=81=E7=A7=BB=E6=AD=A5=E9=AA=A4=E7=B1=BB=E4=BC=BC= =E4=BA=8E=E5=9C=A8=E7=B3=BB=E7=BB=9F=E5=86=85=E5=AD=98=E4=B8=AD=E8=BF=81=E7= =A7=BB NUMA =E9=A1=B5=E9=9D=A2(see :ref:`Page migration `) = =EF=BC=8C +=E6=95=B4=E4=BD=93=E8=BF=81=E7=A7=BB=E6=AD=A5=E9=AA=A4=E7=B1=BB=E4=BC=BC= =E4=BA=8E=E5=9C=A8=E7=B3=BB=E7=BB=9F=E5=86=85=E5=AD=98=E4=B8=AD=E8=BF=81=E7= =A7=BB NUMA =E9=A1=B5=E9=9D=A2(see Documentation/mm/page_migration.rst) =EF= =BC=8C =E4=BD=86=E8=BF=99=E4=BA=9B=E6=AD=A5=E9=AA=A4=E5=88=86=E4=B8=BA=E8=AE=BE= =E5=A4=87=E9=A9=B1=E5=8A=A8=E7=A8=8B=E5=BA=8F=E7=89=B9=E5=AE=9A=E4=BB=A3=E7= =A0=81=E5=92=8C=E5=85=B1=E4=BA=AB=E5=85=AC=E5=85=B1=E4=BB=A3=E7=A0=81: =20 1. ``mmap_read_lock()`` diff --git a/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst b/Doc= umentation/translations/zh_CN/mm/hugetlbfs_reserv.rst index 752e5696cd47..80787af29222 100644 --- a/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst +++ b/Documentation/translations/zh_CN/mm/hugetlbfs_reserv.rst @@ -15,7 +15,7 @@ Hugetlbfs =E9=A2=84=E7=95=99 =E6=A6=82=E8=BF=B0 =3D=3D=3D=3D =20 -:ref:`hugetlbpage` =E4=B8=AD=E6=8F=8F=E8=BF=B0=E7=9A=84=E5=B7=A8=E9=A1=B5= =E9=80=9A=E5=B8=B8=E6=98=AF=E9=A2=84=E5=85=88=E5=88=86=E9=85=8D=E7=BB=99=E5= =BA=94=E7=94=A8=E7=A8=8B=E5=BA=8F=E4=BD=BF=E7=94=A8=E7=9A=84=E3=80=82=E5=A6= =82=E6=9E=9CVMA=E6=8C=87 +Documentation/mm/hugetlbpage.rst =E4=B8=AD=E6=8F=8F=E8=BF=B0=E7=9A=84=E5= =B7=A8=E9=A1=B5=E9=80=9A=E5=B8=B8=E6=98=AF=E9=A2=84=E5=85=88=E5=88=86=E9=85= =8D=E7=BB=99=E5=BA=94=E7=94=A8=E7=A8=8B=E5=BA=8F=E4=BD=BF=E7=94=A8=E7=9A=84= =E3=80=82=E5=A6=82=E6=9E=9CVMA=E6=8C=87 =E7=A4=BA=E8=A6=81=E4=BD=BF=E7=94=A8=E5=B7=A8=E9=A1=B5=EF=BC=8C=E8=BF=99= =E4=BA=9B=E5=B7=A8=E9=A1=B5=E4=BC=9A=E5=9C=A8=E7=BC=BA=E9=A1=B5=E5=BC=82=E5= =B8=B8=E6=97=B6=E8=A2=AB=E5=AE=9E=E4=BE=8B=E5=8C=96=E5=88=B0=E4=BB=BB=E5=8A= =A1=E7=9A=84=E5=9C=B0=E5=9D=80=E7=A9=BA=E9=97=B4=E3=80=82=E5=A6=82=E6=9E=9C= =E5=9C=A8=E7=BC=BA=E9=A1=B5=E5=BC=82=E5=B8=B8 =E6=97=B6=E6=B2=A1=E6=9C=89=E5=B7=A8=E9=A1=B5=E5=AD=98=E5=9C=A8=EF=BC=8C= =E4=BB=BB=E5=8A=A1=E5=B0=B1=E4=BC=9A=E8=A2=AB=E5=8F=91=E9=80=81=E4=B8=80=E4= =B8=AASIGBUS=EF=BC=8C=E5=B9=B6=E7=BB=8F=E5=B8=B8=E4=B8=8D=E9=AB=98=E5=85=B4= =E5=9C=B0=E6=AD=BB=E5=8E=BB=E3=80=82=E5=9C=A8=E5=8A=A0=E5=85=A5=E5=B7=A8=E9= =A1=B5=E6=94=AF =E6=8C=81=E5=90=8E=E4=B8=8D=E4=B9=85=EF=BC=8C=E4=BA=BA=E4=BB=AC=E5=86=B3= =E5=AE=9A=EF=BC=8C=E5=9C=A8mmap()=E6=97=B6=E6=A3=80=E6=B5=8B=E5=B7=A8=E9=A1= =B5=E7=9A=84=E7=9F=AD=E7=BC=BA=E6=83=85=E5=86=B5=E4=BC=9A=E6=9B=B4=E5=A5=BD= =E3=80=82=E8=BF=99=E4=B8=AA=E6=83=B3=E6=B3=95=E6=98=AF=EF=BC=8C=E5=A6=82=E6= =9E=9C diff --git a/Documentation/translations/zh_CN/mm/numa.rst b/Documentation/t= ranslations/zh_CN/mm/numa.rst index b15cfeeb6dfb..61fad89272fa 100644 --- a/Documentation/translations/zh_CN/mm/numa.rst +++ b/Documentation/translations/zh_CN/mm/numa.rst @@ -76,7 +76,7 @@ Linux=E5=B0=86=E7=B3=BB=E7=BB=9F=E7=9A=84=E7=A1=AC=E4=BB= =B6=E8=B5=84=E6=BA=90=E5=88=92=E5=88=86=E4=B8=BA=E5=A4=9A=E4=B8=AA=E8=BD=AF= =E4=BB=B6=E6=8A=BD=E8=B1=A1=EF=BC=8C=E7=A7=B0=E4=B8=BA=E2=80=9C=E8=8A=82=E7= =82=B9=E2=80=9D=E3=80=82 =E7=B3=BB=E7=BB=9F=E7=AE=A1=E7=90=86=E5=91=98=E5=92=8C=E5=BA=94=E7=94=A8= =E7=A8=8B=E5=BA=8F=E8=AE=BE=E8=AE=A1=E8=80=85=E5=8F=AF=E4=BB=A5=E4=BD=BF=E7= =94=A8=E5=90=84=E7=A7=8DCPU=E4=BA=B2=E5=92=8C=E5=91=BD=E4=BB=A4=E8=A1=8C=E6= =8E=A5=E5=8F=A3=EF=BC=8C=E5=A6=82taskset(1)=E5=92=8Cnumactl(1)=EF=BC=8C=E4= =BB=A5=E5=8F=8A=E7=A8=8B =E5=BA=8F=E6=8E=A5=E5=8F=A3=EF=BC=8C=E5=A6=82sched_setaffinity(2)=EF=BC=8C= =E6=9D=A5=E9=99=90=E5=88=B6=E4=BB=BB=E5=8A=A1=E7=9A=84=E8=BF=81=E7=A7=BB=EF= =BC=8C=E4=BB=A5=E6=94=B9=E5=96=84NUMA=E5=AE=9A=E4=BD=8D=E3=80=82=E6=AD=A4= =E5=A4=96=EF=BC=8C=E4=BA=BA=E4=BB=AC=E5=8F=AF=E4=BB=A5=E4=BD=BF=E7=94=A8 Linux NUMA=E5=86=85=E5=AD=98=E7=AD=96=E7=95=A5=E4=BF=AE=E6=94=B9=E5=86=85= =E6=A0=B8=E7=9A=84=E9=BB=98=E8=AE=A4=E6=9C=AC=E5=9C=B0=E5=88=86=E9=85=8D=E8= =A1=8C=E4=B8=BA=E3=80=82 [=E8=A7=81 -:ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `]. +Documentation/admin-guide/mm/numa_memory_policy.rst]. =20 =E7=B3=BB=E7=BB=9F=E7=AE=A1=E7=90=86=E5=91=98=E5=8F=AF=E4=BB=A5=E4=BD=BF= =E7=94=A8=E6=8E=A7=E5=88=B6=E7=BB=84=E5=92=8CCPUsets=E9=99=90=E5=88=B6=E9= =9D=9E=E7=89=B9=E6=9D=83=E7=94=A8=E6=88=B7=E5=9C=A8=E8=B0=83=E5=BA=A6=E6=88= =96NUMA=E5=91=BD=E4=BB=A4=E5=92=8C=E5=8A=9F=E8=83=BD=E4=B8=AD=E5=8F=AF=E4= =BB=A5=E6=8C=87=E5=AE=9A=E7=9A=84CPU=E5=92=8C=E8=8A=82=E7=82=B9 =E7=9A=84=E5=86=85=E5=AD=98=E3=80=82 [=E8=A7=81 Documentation/admin-guide/= cgroup-v1/cpusets.rst] --=20 2.35.1 From nobody Sat Sep 13 16:38:31 2025 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id CBA64C05027 for ; Wed, 1 Feb 2023 09:42:39 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232163AbjBAJmi (ORCPT ); Wed, 1 Feb 2023 04:42:38 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58542 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232171AbjBAJm1 (ORCPT ); Wed, 1 Feb 2023 04:42:27 -0500 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 529BE5EF9F; Wed, 1 Feb 2023 01:42:18 -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 4BB5FB82151; Wed, 1 Feb 2023 09:42:17 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 0CE74C433D2; Wed, 1 Feb 2023 09:42:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1675244536; bh=vz01S7Gn9yA8fYXEMlrMs6OXrICEsx0uxE4+i0GnLtg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=dp/O6NWnyDc86PnlYO59PH9YpDU/bBHMNGcTxC3IDq0Q6FEQmoJpS0g4QAedrSuXm BAqfhaABp7QmLRbPbp4t34gDRril+8ONlNKdUDd+VJ2KLYCETnhGGt60B7KrRqMNyz 4KD5ejjsMfYpTr9+g2QbuTNASCb0TohiUktnEzm1ZmcFPo+sFzDiiG1ZWGfvd9Dl4/ XZBkCNiqQ0TMB+aVYBqV80YuyW6aG3gThTFxmlMWnILsaVbhk9NEWhap4CKmpIFRpn feoVYvCxOBXV085QThNHMQ35/3eAJVSa4Lag4jiAGn0q50qo9c/rE+EsP9xKJETYhu 4Wh2YKeJ1qhLg== 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 3/3] docs/admin-guide/mm: remove useless markup Date: Wed, 1 Feb 2023 11:41:56 +0200 Message-Id: <20230201094156.991542-4-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 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: "Mike Rapoport (IBM)" It is enough to use a file name to cross-reference another rst document. Jon says: 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. Drop reference markup and unnecessary labels and use plain file names. Signed-off-by: Mike Rapoport (IBM) --- Documentation/admin-guide/mm/concepts.rst | 13 +++++-------- Documentation/admin-guide/mm/hugetlbpage.rst | 4 +--- Documentation/admin-guide/mm/idle_page_tracking.rst | 7 ++----- Documentation/admin-guide/mm/index.rst | 3 +-- Documentation/admin-guide/mm/ksm.rst | 2 -- Documentation/admin-guide/mm/memory-hotplug.rst | 2 -- Documentation/admin-guide/mm/numa_memory_policy.rst | 2 -- Documentation/admin-guide/mm/numaperf.rst | 2 -- Documentation/admin-guide/mm/pagemap.rst | 11 ++++------- Documentation/admin-guide/mm/shrinker_debugfs.rst | 2 -- Documentation/admin-guide/mm/soft-dirty.rst | 2 -- Documentation/admin-guide/mm/swap_numa.rst | 2 -- Documentation/admin-guide/mm/transhuge.rst | 2 -- Documentation/admin-guide/mm/userfaultfd.rst | 2 -- Documentation/admin-guide/mm/zswap.rst | 2 -- .../translations/zh_CN/admin-guide/mm/index.rst | 2 +- 16 files changed, 14 insertions(+), 46 deletions(-) diff --git a/Documentation/admin-guide/mm/concepts.rst b/Documentation/admi= n-guide/mm/concepts.rst index c79f1e336222..e796b0a7e4a5 100644 --- a/Documentation/admin-guide/mm/concepts.rst +++ b/Documentation/admin-guide/mm/concepts.rst @@ -1,5 +1,3 @@ -.. _mm_concepts: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Concepts overview =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -86,16 +84,15 @@ memory with the huge pages. The first one is `HugeTLB f= ilesystem`, or hugetlbfs. It is a pseudo filesystem that uses RAM as its backing store. For the files created in this filesystem the data resides in the memory and mapped using huge pages. The hugetlbfs is described at -:ref:`Documentation/admin-guide/mm/hugetlbpage.rst `. +Documentation/admin-guide/mm/hugetlbpage.rst. =20 Another, more recent, mechanism that enables use of the huge pages is called `Transparent HugePages`, or THP. Unlike the hugetlbfs that requires users and/or system administrators to configure what parts of the system memory should and can be mapped by the huge pages, THP manages such mappings transparently to the user and hence the -name. See -:ref:`Documentation/admin-guide/mm/transhuge.rst ` -for more details about THP. +name. See Documentation/admin-guide/mm/transhuge.rst for more details +about THP. =20 Zones =3D=3D=3D=3D=3D @@ -125,8 +122,8 @@ processor. Each bank is referred to as a `node` and for= each node Linux constructs an independent memory management subsystem. A node has its own set of zones, lists of free and used pages and various statistics counters. You can find more details about NUMA in -:ref:`Documentation/mm/numa.rst ` and in -:ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `. +Documentation/mm/numa.rst` and in +Documentation/admin-guide/mm/numa_memory_policy.rst. =20 Page cache =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/hugetlbpage.rst b/Documentation/a= dmin-guide/mm/hugetlbpage.rst index 19f27c0d92e0..5f9121b287d9 100644 --- a/Documentation/admin-guide/mm/hugetlbpage.rst +++ b/Documentation/admin-guide/mm/hugetlbpage.rst @@ -1,5 +1,3 @@ -.. _hugetlbpage: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D HugeTLB Pages =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -313,7 +311,7 @@ memory policy mode--bind, preferred, local or interleav= e--may be used. The resulting effect on persistent huge page allocation is as follows: =20 #. Regardless of mempolicy mode [see - :ref:`Documentation/admin-guide/mm/numa_memory_policy.rst `], + Documentation/admin-guide/mm/numa_memory_policy.rst], persistent huge pages will be distributed across the node or nodes specified in the mempolicy as if "interleave" had been specified. However, if a node in the policy does not contain sufficient contiguous diff --git a/Documentation/admin-guide/mm/idle_page_tracking.rst b/Document= ation/admin-guide/mm/idle_page_tracking.rst index df9394fb39c2..b5a285bd73fd 100644 --- a/Documentation/admin-guide/mm/idle_page_tracking.rst +++ b/Documentation/admin-guide/mm/idle_page_tracking.rst @@ -1,5 +1,3 @@ -.. _idle_page_tracking: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Idle Page Tracking =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D @@ -70,9 +68,8 @@ If the tool is run initially with the appropriate option,= it will mark all the queried pages as idle. Subsequent runs of the tool can then show which pa= ges have their idle flag cleared in the interim. =20 -See :ref:`Documentation/admin-guide/mm/pagemap.rst ` for more -information about ``/proc/pid/pagemap``, ``/proc/kpageflags``, and -``/proc/kpagecgroup``. +See Documentation/admin-guide/mm/pagemap.rst for more information about +``/proc/pid/pagemap``, ``/proc/kpageflags``, and ``/proc/kpagecgroup``. =20 .. _impl_details: =20 diff --git a/Documentation/admin-guide/mm/index.rst b/Documentation/admin-g= uide/mm/index.rst index d1064e0ba34a..1f883abf3f00 100644 --- a/Documentation/admin-guide/mm/index.rst +++ b/Documentation/admin-guide/mm/index.rst @@ -16,8 +16,7 @@ are described in Documentation/admin-guide/sysctl/vm.rst = and in `man 5 proc`_. .. _man 5 proc: http://man7.org/linux/man-pages/man5/proc.5.html =20 Linux memory management has its own jargon and if you are not yet -familiar with it, consider reading -:ref:`Documentation/admin-guide/mm/concepts.rst `. +familiar with it, consider reading Documentation/admin-guide/mm/concepts.r= st. =20 Here we document in detail how to interact with various mechanisms in the Linux memory management. diff --git a/Documentation/admin-guide/mm/ksm.rst b/Documentation/admin-gui= de/mm/ksm.rst index fb6ba2002a4b..eed51a910c94 100644 --- a/Documentation/admin-guide/mm/ksm.rst +++ b/Documentation/admin-guide/mm/ksm.rst @@ -1,5 +1,3 @@ -.. _admin_guide_ksm: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Kernel Samepage Merging =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/memory-hotplug.rst b/Documentatio= n/admin-guide/mm/memory-hotplug.rst index a3c9e8ad8fa0..1b02fe5807cc 100644 --- a/Documentation/admin-guide/mm/memory-hotplug.rst +++ b/Documentation/admin-guide/mm/memory-hotplug.rst @@ -1,5 +1,3 @@ -.. _admin_guide_memory_hotplug: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Memory Hot(Un)Plug =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/numa_memory_policy.rst b/Document= ation/admin-guide/mm/numa_memory_policy.rst index 5a6afecbb0d0..f5cc2a368dac 100644 --- a/Documentation/admin-guide/mm/numa_memory_policy.rst +++ b/Documentation/admin-guide/mm/numa_memory_policy.rst @@ -1,5 +1,3 @@ -.. _numa_memory_policy: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D NUMA Memory Policy =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/numaperf.rst b/Documentation/admi= n-guide/mm/numaperf.rst index 166697325947..24e63e740420 100644 --- a/Documentation/admin-guide/mm/numaperf.rst +++ b/Documentation/admin-guide/mm/numaperf.rst @@ -1,5 +1,3 @@ -.. _numaperf: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D NUMA Locality =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/pagemap.rst b/Documentation/admin= -guide/mm/pagemap.rst index 6e2e416af783..1a22674ab18e 100644 --- a/Documentation/admin-guide/mm/pagemap.rst +++ b/Documentation/admin-guide/mm/pagemap.rst @@ -1,5 +1,3 @@ -.. _pagemap: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D Examining Process Page Tables =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D @@ -19,10 +17,10 @@ There are four components to pagemap: * Bits 0-4 swap type if swapped * Bits 5-54 swap offset if swapped * Bit 55 pte is soft-dirty (see - :ref:`Documentation/admin-guide/mm/soft-dirty.rst `) + Documentation/admin-guide/mm/soft-dirty.rst) * Bit 56 page exclusively mapped (since 4.2) * Bit 57 pte is uffd-wp write-protected (since 5.13) (see - :ref:`Documentation/admin-guide/mm/userfaultfd.rst `) + Documentation/admin-guide/mm/userfaultfd.rst) * Bits 58-60 zero * Bit 61 page is file-page or shared-anon (since 3.5) * Bit 62 page swapped @@ -105,8 +103,7 @@ Short descriptions to the page flags A compound page with order N consists of 2^N physically contiguous pag= es. A compound page with order 2 takes the form of "HTTT", where H donates= its head page and T donates its tail page(s). The major consumers of comp= ound - pages are hugeTLB pages - (:ref:`Documentation/admin-guide/mm/hugetlbpage.rst `), + pages are hugeTLB pages (Documentation/admin-guide/mm/hugetlbpage.rst), the SLUB etc. memory allocators and various device drivers. However in this interface, only huge/giga pages are made visible to end users. @@ -128,7 +125,7 @@ Short descriptions to the page flags Zero page for pfn_zero or huge_zero page. 25 - IDLE The page has not been accessed since it was marked idle (see - :ref:`Documentation/admin-guide/mm/idle_page_tracking.rst `). + Documentation/admin-guide/mm/idle_page_tracking.rst). Note that this flag may be stale in case the page was accessed via a PTE. To make sure the flag is up-to-date one has to read ``/sys/kernel/mm/page_idle/bitmap`` first. diff --git a/Documentation/admin-guide/mm/shrinker_debugfs.rst b/Documentat= ion/admin-guide/mm/shrinker_debugfs.rst index 3887f0b294fe..c582033bd113 100644 --- a/Documentation/admin-guide/mm/shrinker_debugfs.rst +++ b/Documentation/admin-guide/mm/shrinker_debugfs.rst @@ -1,5 +1,3 @@ -.. _shrinker_debugfs: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D Shrinker Debugfs Interface =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D diff --git a/Documentation/admin-guide/mm/soft-dirty.rst b/Documentation/ad= min-guide/mm/soft-dirty.rst index cb0cfd6672fa..aeea936caa44 100644 --- a/Documentation/admin-guide/mm/soft-dirty.rst +++ b/Documentation/admin-guide/mm/soft-dirty.rst @@ -1,5 +1,3 @@ -.. _soft_dirty: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Soft-Dirty PTEs =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/swap_numa.rst b/Documentation/adm= in-guide/mm/swap_numa.rst index e0466f2db8fa..2e630627bcee 100644 --- a/Documentation/admin-guide/mm/swap_numa.rst +++ b/Documentation/admin-guide/mm/swap_numa.rst @@ -1,5 +1,3 @@ -.. _swap_numa: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Automatically bind swap device to numa node =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/transhuge.rst b/Documentation/adm= in-guide/mm/transhuge.rst index 8ee78ec232eb..b0cc8243e093 100644 --- a/Documentation/admin-guide/mm/transhuge.rst +++ b/Documentation/admin-guide/mm/transhuge.rst @@ -1,5 +1,3 @@ -.. _admin_guide_transhuge: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D Transparent Hugepage Support =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/userfaultfd.rst b/Documentation/a= dmin-guide/mm/userfaultfd.rst index 83f31919ebb3..7dc823b56ca4 100644 --- a/Documentation/admin-guide/mm/userfaultfd.rst +++ b/Documentation/admin-guide/mm/userfaultfd.rst @@ -1,5 +1,3 @@ -.. _userfaultfd: - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Userfaultfd =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/admin-guide/mm/zswap.rst b/Documentation/admin-g= uide/mm/zswap.rst index f67de481c7f6..fa5f6c9c78f3 100644 --- a/Documentation/admin-guide/mm/zswap.rst +++ b/Documentation/admin-guide/mm/zswap.rst @@ -1,5 +1,3 @@ -.. _zswap: - =3D=3D=3D=3D=3D zswap =3D=3D=3D=3D=3D diff --git a/Documentation/translations/zh_CN/admin-guide/mm/index.rst b/Do= cumentation/translations/zh_CN/admin-guide/mm/index.rst index 702271c5b683..a8fd2c4a8796 100644 --- a/Documentation/translations/zh_CN/admin-guide/mm/index.rst +++ b/Documentation/translations/zh_CN/admin-guide/mm/index.rst @@ -22,7 +22,7 @@ Linux=E5=86=85=E5=AD=98=E7=AE=A1=E7=90=86=E6=98=AF=E4=B8= =80=E4=B8=AA=E5=85=B7=E6=9C=89=E8=AE=B8=E5=A4=9A=E5=8F=AF=E9=85=8D=E7=BD=AE= =E8=AE=BE=E7=BD=AE=E7=9A=84=E5=A4=8D=E6=9D=82=E7=B3=BB=E7=BB=9F, =E4=B8=94= =E8=BF=99=E4=BA=9B .. _man 5 proc: http://man7.org/linux/man-pages/man5/proc.5.html =20 Linux=E5=86=85=E5=AD=98=E7=AE=A1=E7=90=86=E6=9C=89=E5=AE=83=E8=87=AA=E5=B7= =B1=E7=9A=84=E6=9C=AF=E8=AF=AD=EF=BC=8C=E5=A6=82=E6=9E=9C=E4=BD=A0=E8=BF=98= =E4=B8=8D=E7=86=9F=E6=82=89=E5=AE=83=EF=BC=8C=E8=AF=B7=E8=80=83=E8=99=91=E9= =98=85=E8=AF=BB=E4=B8=8B=E9=9D=A2=E5=8F=82=E8=80=83=EF=BC=9A -:ref:`Documentation/admin-guide/mm/concepts.rst `. +Documentation/admin-guide/mm/concepts.rst. =20 =E5=9C=A8=E6=AD=A4=E7=9B=AE=E5=BD=95=E4=B8=8B=EF=BC=8C=E6=88=91=E4=BB=AC= =E8=AF=A6=E7=BB=86=E6=8F=8F=E8=BF=B0=E4=BA=86=E5=A6=82=E4=BD=95=E4=B8=8ELin= ux=E5=86=85=E5=AD=98=E7=AE=A1=E7=90=86=E4=B8=AD=E7=9A=84=E5=90=84=E7=A7=8D= =E6=9C=BA=E5=88=B6=E4=BA=A4=E4=BA=92=E3=80=82 =20 --=20 2.35.1